在 ServBay 中使用 Yarn 進行 Node.js 套件管理

ServBay 作為一套強大的本機 Web 開發環境，內建對 Node.js 的完整支援。Yarn 是由 Facebook 開發、速度快、可靠且安全的套件管理工具，類似於 npm，但具備更快的套件安裝、更完善的離線支援以及更可靠的相依管理。在 ServBay 的 Node.js 環境中使用 Yarn，能幫助開發者高效管理專案依賴，大幅提升開發效率。

前置條件

在使用 Yarn 之前，請確認您已於 ServBay 裝妥並啟用 Node.js 套件。ServBay 內建的套件管理器可協助您方便地安裝與切換不同版本的 Node.js。

Yarn 的安裝與啟用

經由 ServBay 安裝的 Node.js 套件通常會隨附 Corepack，這是 Node.js 提供的實驗性工具，用來管理並分發各種套件管理器（如 npm、Yarn、pnpm）。Corepack 通常可讓您直接使用 yarn 指令，並在需要時協助安裝特定版本的 Yarn。

確認 Yarn 是否已安裝

在開始使用 Yarn 前，您應先確認其於您的 ServBay 環境中是否可用。請打開終端機，輸入以下指令以檢查 Yarn 版本：

yarn -v

若 Yarn 已安裝於系統的 PATH 中，您將會看到例如下方的版本號輸出：

1.22.19

或更高版本。

透過 Corepack 安裝或更新 Yarn

首次執行 yarn 指令時，若 Corepack 偵測到需安裝特定 Yarn 版本，可能會顯示類似下方的提示：

$ yarn -v
! Corepack is about to download https://registry.yarnpkg.com/yarn/-/yarn-1.22.22.tgz
? Do you want to continue? [Y/n]

這是 Corepack 正在詢問您是否允許下載並安裝指定的 Yarn 版本。請輸入 Y 並按下 Enter 鍵以繼續。完成後，Corepack 會自動使用所下載之 Yarn 版本，並顯示該版本號：

1.22.22

透過 npm 手動安裝或更新 Yarn

若您未看到 Corepack 提示，或者想要透過 npm 手動安裝／更新全域 Yarn 版本，可使用下列指令：

npm install -g yarn

此指令會由全域安裝的 npm 來安裝／更新 Yarn 執行檔。

安裝或更新完成後，再次查詢版本號以確認 Yarn 已正確啟用並升級：

yarn -v

經過上述步驟，您即可確保 Yarn 已正確安裝並升級至最新版本，可於 ServBay 環境管理 Node.js 專案之相依套件。

Yarn 的優勢與核心用法

Yarn 主要優勢在於快速安裝、優秀離線支援、以及更可靠的相依處理。以下整理一些 Yarn 常用指令範例：

初始化新專案

於專案根目錄下，透過 Yarn 初始化 Node.js 新專案，並建立 package.json 檔案：

yarn init

系統會引導您填寫專案基本資訊，並最終產生 package.json 檔案。

安裝專案相依套件

於包含 package.json 的專案目錄，執行下方指令安裝所有列於檔案內的依賴：

yarn install

該指令會依據 package.json 及 yarn.lock 安裝所有需要的套件至 node_modules 目錄。

新增依賴套件

新增一個正式環境依賴（會加入 dependencies）：

yarn add lodash

新增一個開發環境依賴（會加入 devDependencies）：

yarn add --dev jest

新增一個全域可用的依賴套件（通常不建議此做法，建議優先使用 npx 或全域工具）：

yarn global add <package-name>

移除依賴套件

自專案中移除一個依賴：

yarn remove lodash

此步驟會從專案移除 lodash 並自動更新 package.json 與 yarn.lock。

升級專案相依

一次性將所有依賴升級至 package.json 內所設定範圍內的最新版本：

yarn upgrade

若需升級至最新版主版本、次版本或修補版本，可搭配 yarn upgrade --latest 或其他工具（如 yarn-upgrade-all）一起使用。

執行專案腳本

您可以在 package.json 的 "scripts" 欄位自訂各種命令，以便執行專案相關任務（如啟動開發伺服器、執行測試、專案建置等）。

舉例來說，在 package.json 中設定如下腳本：

"scripts": {
  "start": "node app.js",
  "test": "jest",
  "build": "webpack --config webpack.config.js"
}

之後可透過下列指令直接執行：

yarn start
yarn test
yarn build

其他常用 Yarn 指令

• 安裝全域套件：

  yarn global add <package-name>

  例如，安裝全域 create-react-app 腳手架：

  yarn global add create-react-app

• 檢視全域套件列表：

  yarn global list

• 清除快取： Yarn 會快取已下載套件，加速未來安裝。如遇快取相關問題可清除之：

  yarn cache clean

  若您使用的是 Yarn v2 以上版本，快取清除指令可能不同，請參考對應版本官方文件。

總結

透過於 ServBay 的 Node.js 環境正確安裝及運用 Yarn，可大幅提升專案相依管理效率與穩定度。無論初始化新專案、安裝或升級套件、執行自訂腳本，Yarn 都提供高速且可靠的解決方案，是現代 Node.js 開發不可或缺的重要工具。結合 ServBay 提供的高效環境，以及 Yarn 的強大功能，您的本機開發流程將更加流暢高效。