添加依赖包
当你想使用另一个包时,你要先把它添加到依赖列表中。也就是执行 yarn add [package-name]
命令将它安装到你的项目中。
这也将同时更新你的 package.json
和 yarn.lock
文件,这样,同一项目的其他开发者也可以通过执行 yarn
或者 yarn install
来安装同样的依赖。
大部分包会通过 npm registry 来安装,只需指定包的名字即可。例如,yarn add react
命令会通过 npm registry 来安装 react
包。
你可以用以下任何方法指定版本号:
yarn add package-name
命令用来安装包的 “最新(latest)” 版本。yarn add [email protected]
命令将通过 npm registry 来安装这个包的指定版本。yarn add [email protected]
命令用来安装具有某个 “标签(tag)” 的包(例如:beta
、next
或latest
)。
通常,一个包就是一个装有代码和 package.json
文件的文件夹,package.json
文件用于描述这个包的内容。你可以用多种方式来引用一个包:
你还可以引用不同位置上的包:
yarn add package-name
命令通过 npm registry 安装指定的包,除非你在package.json
中指定了另一个 registry。yarn add file:/path/to/local/folder
命令从你的本地文件系统中安装一个包。这种方式用于测试你还没有发布到 registry 的包。yarn add file:/path/to/local/tarball.tgz
命令从 gzip 压缩文件中安装一个包,这种方式用于在正式发布之前分享一个包。yarn add <git remote url>
命令从远程的 git 仓库中安装一个包。yarn add <git remote url>#<commit/tag>
命令远程的 git 仓库中安装一个指定了 git commit 或 git tag 的包。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 [email protected]
将会安装 1.9.1
,但是 yarn add [email protected] --exact
将会安装 1.2.3
。
yarn add <package...> [--tilde/-T]
添加 --tilde
或 -T
参数将安装相同副版本(minor version)号的最新版本的包。默认是安装相同主版本(major version)号的最新版本的包。例如,yarn add [email protected] --tilde
将安装 1.2.9
而不是 1.3.0
。