• 添加依赖包
  • 注意事项
  • 命令
    • yarn add <package…>
    • yarn add <package…> [—dev/-D]
    • yarn add <package…> [—peer/-P]
    • yarn add <package…> [—optional/-O]
    • yarn add <package…> [—exact/-E]
    • yarn add <package…> [—tilde/-T]

    安装一个包(以及任何它依赖的包)。

    添加依赖包

    一般而言,一个包是一个包含代码的文件夹和一个描述包内容的package.json文件。 如果你想使用其他包,首先要将其加入依赖列表。 也就是执行yarn add [package-name]命令,来为项目安装所需的包。

    同时,这个命令会更新package.jsonyarn.lock文件,以便使本项目的其他开发者可以使用yarn或者yarn install来安装相同的依赖。

    大多数的包会从npm registry目录里以包名来安装。 例如,yarn add react会从npm registry里安装react包。

    你可以用以下方法指定版本号:

    • yarn add package-name 会安装 latest 最新版本。
    • yarn add package-name@1.2.3 会从 registry 里安装这个包的指定版本。
    • yarn add package-name@tag 会安装某个 “tag” 标识的版本(比如 betanext 或者 latest)。
      你也可以指定不同路径的包:

    • yarn add package-name 从 npm registry 里安装包,除非你在 package.json 指定了其它 registry。

    • yarn add file:/path/to/local/folder 从本地文件系统里安装一个包,可以用这种方式来测试还未发布的包。
    • yarn add file:/path/to/local/tarball.tgz 安装一个 gzipped 压缩包,此格式可以用于在发布之前分享你的包。
    • yarn add <git remote url> 从远程 git repo 里安装一个包。
    • yarn add <git remote url>#<branch/commit/tag> 从一个远程 git 仓库指定的 git 分支、git 提交记录或 git 标签安装一个包。
    • yarn add https://my-project.org/package.tgz 用一个远程 gzipped 压缩包来安装。

    注意事项

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

    对于绝大部分包来说,这是个坏习惯,因为它们是隐藏的。 最好本地安装你的依赖,这样它们都是明确的,每用你项目的人都能得到同样的依赖。

    如果你想用有 bin 的命令行 CLI 工具,可以在 ./node_modules/.bin 路径里访问。 你也可以用 global 命令:

    1. 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 会安装包的精确版本。 默认是安装包的主要版本里的最新版本。 比如说, 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 来安装包的次要版本里的最新版。 默认是安装包的主要版本里的最新版本。 比如说,yarn add foo@1.2.3 —tilde 会接受 1.2.9,但不接受 1.3.0

    原文: https://yarnpkg.com/zh-Hans/docs/cli/add