yarn使用文档

新手指南

Yarn 对你的代码来说是一个包管理器，你可以通过它使用全世界开发者的代码，或者分享自己的代码。 Yarn 做这些快捷、安全、可靠，所以你不用担心什么。

通过Yarn你可以使用其他开发者针对不同问题的解决方案，使自己的开发过程更简单。使用过程中遇到问题，你可以将其上报或者贡献解决方案。一旦问题被修复，Yarn会更新保持同步。

代码通过包（package）（或者称为模块（module））的方式来共享。一个包里包含所有需要共享的代码，以及描述包信息的文件，称为package.json。

稳定版：v1.3.2
Node.js版本：^4.8.0 || ^5.7.0 || ^6.2.2 || ^8.0.0

在你使用 Yarn 之前，你需要先在系统中安装它。有一些不同的方法（还在增加）安装 Yarn：

在 Windows 系统中安装 Yarn 有多种方法

这将给你一个.msi 文件(下载安装程序)，当你运行它时带领你安装 Yarn 到 Windows 上。

前提，你需要先安装 Node.js。

Chocolatey 是一个适用于 Windows 的包管理器，您可以用这个*操作方式*安装。

如果你已经安装了 Chocolatey，你可以在你的控制台里运行下面的指令安装 yarn：

1	choco install yarn

同样的，你需要确保先安装了 Node.js。

Scoop 是一个 Windows 的命令行安装程序，你可以用这些指令安装 Scoop。

安装好了 Scoop 后，你可以在控制台里运行下面的代码安装 yarn：

1	scoop install yarn

如果之前没有安装 Node.js，scoop 将给你一个建议来安装它。例如：

1	scoop install nodejs

**注意：**一般来说, 不推荐通过 npm 安装 Yarn 在用基于 Node 的包管理器安装 Yarn 时，该包未被签名，并且只通过基本的 SHA1 散列进行唯一完整性检查。这在安装系统级应用时有安全风险。

因为这些原因，高度推荐用你的操作系统最适合的方式来安装 Yarn。

你还可以通过 npm package manager 来安装 Yarn。如果你已经装了Node.js，那你应该已经有 npm 了。
安装好 npm 后你可以用如下命令来安装 yarn：

1	npm install --global yarn

此外你还需要在终端里设置PATH环境变量来全局访问 Yarn 的二进制可执行程序。
添加 set PATH=%PATH%;C:\.yarn\bin 到你的 shell 环境。

提示：
请把你的项目目录和 Yarn 缓存目录 (%LocalAppData%\Yarn) 加到你的杀毒软件白名单里，否则安装包时会明显变慢，每个写入到硬盘时将被扫描。

运行如下命令：

1	yarn --version

Nightly Builds 是 Yarn 最新和最大的版本，使用最新的 Yarn 代码构建。Nightly Builds 对于尝试还没有作为稳定版发布的新功能或测试 bug 修复很有用。这些 Builds 不保证稳定并且可能有 bugs。
请参阅如何安装 Nightly Builds

有问题吗？如果你不能用这些安装程序安装 Yarn，请通过 GitHub 搜索一个 issue 或者开一个新的 issue。

搜索现有的 issue · 开一个新的 issue

现在Yarn已经安装完毕，可以开始使用。以下是一些你需要的最常用的命令：

yarn init

1
2
3

yarn add [package]
yarn add [package]@[version]
yarn add [package]@[tag]

将依赖项添加到不同依赖项类别
分别添加到 devDependencies、peerDependencies 和 optionalDependencies：

1
2
3

yarn add [package] --dev
yarn add [package] --peer 
yarn add [package] --optional

1
2
3

yarn upgrade [package]
yarn upgrade [package]@[version]
yarn upgrade [package]@[tag]

1	yarn remove [package]

1
2
3

yarn
或者
yarn install

延伸阅读
Yarn 工作流(如何使用Yarn？方便的创建与使用Yarn包的工作流程将帮你快速提高生产力。)
CLI 命令(Yarn 通过一组丰富的命令执行包安装、管理、发布等操作。)

官方文档