yarn-cli 添加

添加依赖包

当你想使用另一个包时，你要先把它添加到依赖列表中。也就是执行 yarn add [package-name] 命令将它安装到你的项目中。

这也将同时更新你的 package.json 和 yarn.lock 文件，这样，同一项目的其他开发者也可以通过执行 yarn 或者 yarn install 来安装同样的依赖。

大部分包会通过 npm registry 来安装，只需指定包的名字即可。例如，yarn add react 命令会通过 npm registry 来安装 react 包。

你可以用以下任何方法指定版本号：

1. yarn add package-name 命令用来安装包的 “最新（latest）” 版本。
2. yarn add package-name@1.2.3 命令将通过 npm registry 来安装这个包的指定版本。
3. yarn add package-name@tag 命令用来安装具有某个 “标签（tag）” 的包（例如： beta、next 或 latest）。

通常，一个包就是一个装有代码和 package.json 文件的文件夹，package.json 文件用于描述这个包的内容。你可以用多种方式来引用一个包：

你还可以引用不同位置上的包：

1. yarn add package-name 命令通过 npm registry 安装指定的包，除非你在 package.json 中指定了另一个 registry。
2. yarn add file:/path/to/local/folder 命令从你的本地文件系统中安装一个包。这种方式用于测试你还没有发布到 registry 的包。
3. yarn add file:/path/to/local/tarball.tgz 命令从 gzip 压缩文件中安装一个包，这种方式用于在正式发布之前分享一个包。
4. yarn add <git remote url> 命令从远程的 git 仓库中安装一个包。
5. yarn add <git remote url>#<commit/tag> 命令远程的 git 仓库中安装一个指定了 git commit 或 git tag 的包。
6. yarn add https://my-project.org/package.tgz 命令从一个远程的 gzip 压缩文件中安装一个包。

注意事项

如果你以前用过类似于 npm 的包管理器，你可能会想如何全局安装依赖包。

对于绝大部分包来说，全局安装个坏实践，因为它们是隐性的。最好本地安装你的依赖包，这样它们都是明确的，每个参与项目的人都能安装同样的依赖包。

如果你正在尝试使用一个命令行（CLI）工具，你可以在 ./node_modules/.bin 目录下找到这个工具所自带的 可执行文件（bin）。你也可以用 global 命令：

yarn global add <package...>

命令

yarn add <package...>

按照 dependencies 列出的依赖列表安装一个或多个包。

yarn add <package...> [--dev/-D]

添加 --dev 或 -D 参数将按照 devDependencies 列出的依赖列表安装一个或多个包。

yarn add <package...> [--peer/-P]

添加 --peer 或 -P 参数将按照 peerDependencies 列出的依赖列表安装一个或多个包。

yarn add <package...> [--optional/-O]

添加 --optional 或 -O 参数将按照 optionalDependencies 列出的依赖列表安装一个或多个包。

yarn add <package...> [--exact/-E]

添加 --exact 或 -E 参数将安装指定版本的包。默认是安装相同主版本（major version）号的最新版本的包。例如， yarn add foo@1.2.3 将会安装 1.9.1，但是 yarn add foo@1.2.3 --exact 将会安装 1.2.3。

yarn add <package...> [--tilde/-T]

添加 --tilde 或 -T 参数将安装相同副版本（minor version）号的最新版本的包。默认是安装相同主版本（major version）号的最新版本的包。例如，yarn add foo@1.2.3 --tilde 将安装 1.2.9 而不是 1.3.0。