yarn add

安裝套件以及任何與它相依的套件

新增相依套件

一般而言,一個套件是一個套件程式碼的文件夾和一個描述檔案内容的package.json文件。 如果你想使用其他套件,首先要將其加入相依列表。 也就是執行yarn add [package-name]指令,來為專案安裝所需的套件。

這同時會更新你的 package.jsonyarn.lock,使得同個專案的其他開發者可以在執行yarnyarn install 獲得同樣的相依套件。

大部份的套件會透過它們的名字自 npm 安裝。 例如: yarn add react 會從 npm 安裝 react

你可以透過以下的任一個方式指訂安裝的版本:

  1. yarn add package-name 會安裝 “latest” 的版本。
  2. yarn add package-name@1.2.3 會安裝指定的版本。
  3. yarn add package-name@tag 會安裝指定的 “tag” (例如: betanext、 或 latest)。

同時,你也可以指定不同的安裝來源:

  1. yarn add package-name 將自 npm registry 安裝套件,除非你在 package.json 中指定了不同的來源。
  2. yarn add file:/path/to/local/folder 將安裝位於本機的套件。這對於測試還未發佈在套件庫上的套件上很有用。
  3. yarn add file:/path/to/local/tarball.tgz 將自由 gzip 壓縮的 tarball 安裝,這格式使得你可以在發佈前分享套件。
  4. yarn add <git remote url> 將自遠端的 git 的套件庫安裝套件。
  5. yarn add <git remote url>#<branch/commit/tag> 從一個遠程的 git 倉庫指定的 git 分支、git commit 或 git tag 來安裝一個套件。
  6. yarn add https://my-project.org/package.tgz 將安裝來自遠端的由 gzip 壓縮 tarball。

注意事項

如果你曾使用其它的套件管理器,如 npm,你可能在尋找如何新增全域的相依性。

對於大部份的套件而言,這不是一個好作法,因為它們的相依是隱性的。 更好的作法是將它們加入你的專案的相依性中,使得它們是顯性的,且所有使用你的專案的人可以得到同樣的相依關係。

如果你想要使用一個 CLI 下擁有 bin 的工具,你可以在 ./node_modules/.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]

使用 --exactE 安裝確切的指定版本。 預設會使用主版本號相符的最新的版本。 例如: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