Yarn 是一個快速、可靠且安全的依賴包管理工具,用于替代 npm。以下是在不同操作系統上安裝和配置 Yarn 的步驟。
1. 安裝 Node.js
在安裝 Yarn 之前,請確保已經安裝了 Node.js,因為 Yarn 需要 Node.js 環境。你可以在 Node.js — Run JavaScript Everywhere 下載并安裝適合你操作系統的版本。
2. 在 Ubuntu / Debian 上安裝 Yarn
在 Ubuntu 或 Debian 系統上,可以通過以下命令使用包管理器 apt 來安裝 Yarn:
Bash
1curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
2echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
3sudo apt-get update && sudo apt-get install yarn
3. 在 CentOS / RHEL 上安裝 Yarn
在 CentOS 或 RHEL 系統上,可以使用以下命令通過包管理器 yum 或 dnf 來安裝 Yarn:
Bash
1curl -sS https://dl.yarnpkg.com/rpm/pubkey.gpg | sudo rpm --import -
2echo -e "[yarn]\nname=Yarn\nbaseurl=https://dl.yarnpkg.com/rpm/\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://dl.yarnpkg.com/rpm/pubkey.gpg" | sudo tee /etc/yum.repos.d/yarn.repo
3sudo yum install yarn
4# 如果你的系統使用的是dnf,替換上面的yum為dnf即可
4. 在 macOS 上安裝 Yarn
在 macOS 上,可以使用 Homebrew 包管理器來安裝 Yarn:
Bash
1brew install yarn
5. 在 Windows 上安裝 Yarn
在 Windows 上,你可以通過 Chocolatey 包管理器或直接從 Yarn 官網下載安裝包進行安裝。
- 使用 Chocolatey:
1choco install yarn
- 從官網下載:訪問?Installation | Yarn?,下載并運行安裝程序。
6. 配置 Yarn
安裝完成后,你可能需要對 Yarn 進行一些基本配置,例如設置全局安裝目錄和緩存目錄。可以通過編輯 .yarnrc
文件(位于用戶主目錄下)來完成這些配置。
例如,要將全局安裝目錄設置為 /usr/local/lib/node_modules
和緩存目錄設置為 /var/cache/yarn
,可以添加以下內容到 .yarnrc
文件中:
1yarn-offline-mirror: false
2global-folder: "/usr/local/lib/node_modules"
3cache-folder: "/var/cache/yarn"
請根據實際情況調整路徑。
成功安裝和配置了 Yarn,可以開始使用它來管理 項目依賴了!
Yarn 是一個高效、可靠且安全的包管理器,它與 npm 兼容但提供了更快的安裝速度和更好的依賴一致性。以下是 Yarn 的基本用法概覽,這將幫助你快速上手使用 Yarn:
7.基本命令
初始化項目
若要初始化一個新的項目,使用 yarn init 命令。這會創建一個 package.json 文件,并引導你填寫項目信息。
添加依賴
使用 yarn add <package> 來安裝一個新包。例如,安裝 lodash 庫:
yarn add lodash
安裝項目依賴
要安裝項目中列出的所有依賴,只需運行 yarn 或 yarn install。Yarn 會讀取 package.json 中的 dependencies 和 devDependencies 列表。
升級依賴
若要升級一個已存在的依賴到最新版本,使用 yarn upgrade <package>。
移除依賴
使用 yarn remove <package> 來移除一個不再需要的包。
列出所有依賴
yarn list 命令顯示所有已安裝的依賴包及其版本。
檢查依賴
yarn check 可以驗證項目中的依賴是否與 package-lock.json 或 yarn.lock 文件中的信息匹配。
清理緩存
使用 yarn cache clean 清除 Yarn 的緩存。
全局安裝
若要全局安裝一個包,使用 yarn global add <package>。
8.高級功能
鏈接本地模塊
使用 yarn link 和 yarn link <package> 命令來鏈接本地開發的模塊到項目中,這樣就可以在開發過程中實時看到模塊的變化。
工作空間
大型項目可能包含多個子項目,每個子項目都有自己的 package.json。Yarn 的工作空間功能可以幫助管理這些子項目。在根目錄的 package.json 文件中定義 workspaces 字段,然后可以使用 yarn workspaces <command> 來針對所有工作空間執行命令。
插件
Yarn 支持插件,可以擴展其功能。使用 yarn plugin import <plugin-name> 來安裝插件。
多版本支持
Yarn 允許同時安裝不同版本的相同包,這在處理不同的項目需求時非常有用。
9.日常使用技巧
腳本運行
除了管理依賴,package.json 中的 scripts 字段可以用來定義常用任務,例如構建、測試和部署。使用 yarn <script-name> 來運行這些腳本。
環境變量
Yarn 可以通過 .env 文件或環境變量來設置項目級別的環境變量,這對于配置不同的環境(如開發、測試和生產)很有幫助。
鎖定文件
Yarn 使用 yarn.lock 文件來跟蹤確切的依賴版本,確保在任何環境中安裝的依賴完全一致。
10.構建和發布
-
構建和打包
如果你的項目有構建步驟,比如編譯源代碼或者壓縮資源文件,可以在package.json
的scripts
字段中定義一個build
腳本,然后使用yarn build
來運行這個腳本。 -
發布到npm倉庫
使用yarn publish
命令可以將你的項目發布到 npm 倉庫。在發布前,請確保你已經在 npm 登錄過 (npm login
) 并且你的package.json
文件中的version
字段已經更新。
11.檢查和審計
-
依賴關系圖
使用yarn why <package>
查看特定包是如何被引入項目的,以及它的所有依賴樹。 -
依賴審計
yarn audit
命令可以檢查你的項目是否存在已知的安全漏洞,并提供修復建議。
12.自動化和CI/CD
-
自動化腳本
你可以將yarn
命令集成到 CI/CD 流水線中,例如在構建流程中自動運行yarn install
和yarn test
。 -
環境變量和配置
利用.env
文件或環境變量來存儲敏感信息,如 API 密鑰和數據庫連接字符串,以避免硬編碼到代碼中。
13.性能優化
-
使用離線模式
當網絡不穩定或不可用時,可以使用yarn install --offline
命令,Yarn 將嘗試從本地緩存安裝依賴。 -
自定義鏡像源
對于國內用戶,可以通過修改.yarnrc
文件中的registry
設置來使用國內的 npm 鏡像源,例如阿里云鏡像,以提高下載速度。
14.最佳實踐
-
保持
yarn.lock
文件同步
每次修改依賴后,都應該提交更新后的yarn.lock
文件到版本控制系統,確保團隊成員使用相同的依賴版本。 -
定期更新依賴
定期運行yarn outdated
檢查過時的依賴,然后使用yarn upgrade
更新它們,以獲取最新的安全補丁和功能改進。 -
使用Workspaces管理多項目
如果你的項目包含多個獨立的子項目,考慮使用 Workspaces 功能來簡化依賴管理和構建過程。 -
文檔和注釋
在package.json
和README.md
文件中詳細記錄項目的依賴、腳本和安裝步驟,以便新加入的開發者能夠快速上手。