如何安装和使用 Yarn 包管理器用于 Node.js

介紹

Yarn 是一個針對 Node.js 的套件管理器,著重於速度、安全性和一致性。它最初是為了解決流行的 NPM 套件管理器的一些問題而創建的。雖然這兩個套件管理器在性能和功能上已經趨於一致,但 Yarn 仍然很受歡迎,特別是在 React 開發領域。

Yarn 的一些獨特功能包括:

  • A per-project caching mechanism, that can greatly speed up subsequent installs and builds
  • 保證安裝庫結構始終相同的一致性、確定性安裝
  • 所有套件的校驗和檢測以驗證其完整性
  • “工作區”,有助於在單一源代碼存儲庫中使用 Yarn(在一個存儲庫中開發多個項目)

在本教程中,您將全局安裝 Yarn,將 Yarn 添加到特定項目中,並學習一些基本的 Yarn 命令。

使用 DigitalOcean App Platform 從 GitHub 部署您的前端應用程序。讓 DigitalOcean 專注於擴展您的應用程序。

安裝及使用 Node.js 的 Yarn 套件管理器

  1. 全域安裝 Yarn
  2. 在您的專案中安裝 Yarn
  3. 使用 Yarn

先決條件

在安裝並使用 Yarn 套件管理器之前,您需要先安裝 Node.js。要檢查您是否已安裝了 Node.js,請在您的本機命令列終端機中輸入以下命令:

  1. node -v

如果您看到像 v12.16.3 這樣的版本號印出,表示您已經安裝了 Node.js。如果您收到 command not found 的錯誤(或類似的措辭),請先安裝 Node.js,然後再繼續。

安裝 Node.js,請參照我們的教程進行UbuntuDebianCentOSmacOS的安裝。

當您安裝完 Node.js 後,請進入第一步安裝 Yarn 套件管理器。

第一步 — 全域安裝 Yarn

Yarn 有一種獨特的方式在您的 JavaScript 專案中安裝和執行自身。首先,您全域安裝yarn命令,然後使用全域yarn命令將特定的本地版本 Yarn 安裝到您的專案目錄中。這是必要的,以確保所有在專案上工作的人(以及專案的所有自動測試和部署工具)都使用相同版本的yarn,以避免不一致的行為和結果。Yarn 的維護者建議使用 NPM 套件管理器全域安裝 Yarn,NPM 套件管理器預設與所有 Node.js 安裝一起提供。使用npm install命令時使用-g標誌來執行此操作:

Yarn 的維護者建議使用 NPM 套件管理器(所有 Node.js 安裝中預設包含)將 Yarn 全域安裝。使用 npm install 搭配 -g 旗標來進行此操作:

  1. sudo npm install -g yarn

安裝完成後,使用 yarn 命令列印其版本號。這將讓您確認它是否已正確安裝:

  1. yarn --version
Output
1.22.11

現在您已經全域安裝了 yarn 命令,您可以使用它將 Yarn 安裝到特定的 JavaScript 專案中。

步驟 2 — 在您的專案中安裝 Yarn

如果您正在使用 Yarn 與現有的 Yarn 基礎專案合作,則可以跳過此步驟。該專案應該已經設置了本地版本的 Yarn 以及使用它所需的所有配置文件。

如果您正在設置自己的新專案,則現在需要配置專案特定的 Yarn 版本。

首先,導航到您的專案目錄:

  1. cd ~/my-project

如果您沒有專案目錄,可以使用 mkdir 創建一個新的,然後移動到該目錄中:

  1. mkdir my-project
  2. cd my-project

現在使用 yarn set 命令將版本設置為 berry

  1. yarn set version berry

這將下載當前正在積極開發的 Yarn 版本 — berry — 將其保存到您的專案中的 .yarn/releases/ 目錄,並設置 .yarnrc.yml 配置文件:

Output
Resolving berry to a url... Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js... Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs... Updating /home/sammy/my-project/.yarnrc.yml... Done!

現在再次嘗試運行 yarn --version 命令:

  1. yarn --version
Output
3.0.0

您將看到版本號是 3.0.0 或更高。這是Yarn的最新版本。

注意:如果您使用 cd 命令退出項目目錄並再次運行 yarn --version,您將再次獲得全局Yarn的版本號,在本例中為 1.22.11。每次運行 yarn 命令時,都會使用全局安裝的版本。全局 yarn 命令首先檢查它是否在一個包含 .yarnrc.yml 文件的Yarn項目目錄中,如果是,它會將命令轉交給在項目的 yarnPath 設置中配置的項目特定版本的Yarn。

您的項目現在已經設置了項目特定的Yarn版本。接下來,我們將查看一些常用的 yarn 命令來開始使用。

使用Yarn

Yarn有許多子命令,但您只需要幾個就可以開始。讓我們來看看您將首先使用的子命令。

獲取幫助

在開始使用任何新工具時,學習如何訪問其線上幫助非常有用。在Yarn中,可以在任何命令後添加 --help 標誌以獲取更多信息:

  1. yarn --help

這將會列印出yarn命令的整體幫助信息。若要獲取某個子命令的更詳細信息,可以在子命令後面加上--help

  1. yarn install --help

這將會列印出yarn install命令的使用詳情。

開始新的Yarn專案

如果你正在從零開始一個專案,可以使用init子命令來創建你需要Yarn專屬文件:

  1. yarn init

這將會在你的目錄中添加一個package.json配置文件和一個yarn.lock文件。package.json包含了配置和你的模組依賴列表。yarn.lock文件鎖定了這些依賴到特定的版本,確保依賴樹始終保持一致。

安裝專案的所有依賴

要在現有的Yarn基礎專案中下載和安裝所有依賴,使用install子命令:

  1. yarn install

這將會下載並安裝你需要的模組以開始工作。

將新依賴項添加到項目中

使用add子命令將新依賴項添加到項目中:

  1. yarn add package-name

這將下載該模塊,安裝它,並更新您的package.jsonyarn.lock文件。

更新您的.gitignore文件以使用Yarn

Yarn將文件存儲在項目目錄內的.yarn文件夾中。其中一些文件應該被檢入版本控制,而其他文件應該被忽略。Yarn的基本.gitignore配置如下:

.gitignore
.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

這將忽略整個.yarn目錄,然後添加一些例外,包括包含您的項目特定版本的Yarn的releases目錄。

有關如何配置Git和Yarn的更多詳細信息,請參閱官方Yarn文檔中的.gitignore

結論

在本教程中,您安裝了Yarn並學習了一些yarn子命令。如需了解更多使用Yarn的信息,請查閱官方Yarn CLI文檔

如需更一般的Node.js和JavaScript幫助,請訪問我們的Node.jsJavaScript標籤頁面,您將在那裡找到相關的教程、技術講座和社區問答。

Source:
https://www.digitalocean.com/community/tutorials/how-to-install-and-use-the-yarn-package-manager-for-node-js