這篇從四個角度談 yarn:它相對 npm 解決了什麼問題、怎麼正確安裝、常用命令有哪些、以及實際使用心得。
yarn 有本地快取目錄,裝過的包再裝一次不必重新下載。npm 最受詬病的正是這一點:每次安裝都從網路重新抓一整批。
我們公司部署 node 專案時,必須在發布機上 install 全部依賴,而那台機器網路環境不佳,裝得慢又常常失敗(部分包還需要連網編譯)。換成 yarn 之後,只要把 cache 目錄保存下來,每次安裝速度立刻有感提升。
同一個專案在不同機器上安裝,產生的依賴樹結構與版本完全一致。
npm 在這裡有個處理不佳之處。舉例:專案直接依賴 A、B、C 並都指定了版本,但 A 又依賴 D、E、F,D 又依賴 G、H……這麼多層關聯依賴裡,很可能某個包沒鎖版本。於是換一台機器安裝、或刪掉 node_modules 重裝,那些沒鎖版本的子依賴可能剛好發布了新版,導致裝出來的東西跟原本不同,原本能跑的程式突然一堆 bug。
npm 對安裝順序也相當敏感。在空專案裡依序執行:
npm init -y npm install globule@0.1.0 -S npm install babel-generator@6.19.0 -S npm install babel-helper-define-map@6.18.0 -S
這三個包都依賴 lodash,但 globule 要的是 lodash@1.0.3,另外兩個要 lodash@4.x。

此時若專案裡直接 require lodash 卻忘了自己安裝:
var lodash = require('lodash');
console.log(lodash.VERSION); // v1.0.3
同事拉下程式碼執行 npm install 後,第一層的 lodash 可能變成 4.x,這就是「在我電腦上明明可以跑」的典型來源。yarn 則保證無論安裝順序為何,依賴樹結構都一致。
下載時會最佳化請求順序,避免 request waterfall。
某個包下載失敗時 yarn 會自動重試,npm 則直接失敗中斷,得重來一次。
同一個包無論被多少個間接依賴引用,只會從一個 registry 安裝,避免 npm 與 bower 混用造成的版本錯亂。
多個包依賴同一個子包時,yarn 會盡量提取成同一份,避免到處副本佔空間。
安裝過程的訊息帶點表情符號,純粹是心理層面的愉悅。

yarn 依賴 node 環境。官網列了各平台的 N 種裝法(brew、yum、apt 等),但其實最通用、最省事的還是:
npm install yarn -g
yarn init 會進入互動問答,詢問 package 相關資訊:
question name (testdir): my-awesome-package question version (1.0.0): question description: The best package you will ever find. question entry point (index.js): question git repository: https://github.com/yarnpkg/example-yarn-package question author: Yarn Contributor question license (MIT): success Saved package.json Done in 87.70s.
加上 --yes 或 -y 可跳過提問直接產出 package.json。
yarn add [package]@[version/tag] 會自動寫入 package.json 並更新 yarn.lock。要加到其他分類:
yarn add --dev/-D → devDependenciesyarn add --peer/-P → peerDependenciesyarn add --optional/-O → optionalDependenciesyarn upgrade [package]@[version/tag] 更新版本並同步兩個檔案。
yarn remove [package] 移除依賴。
yarn install 依 package.json 安裝,並依 yarn.lock 鎖定版本,確保不同機器裝出來的結構完全一致。常用參數:
--flat:同一包只允許存在一個版本,遇到衝突會開互動視窗讓你選。
--force:強制重新下載所有包。
--production:只裝 dependencies,略過 devDependencies。
在指令前加 global 即可,支援 add、bin、ls、remove、upgrade。例如 npm install gulp -g 可寫成 yarn global add gulp。
換源可以走淘寶鏡像:yarn config set registry 'https://registry.npm.taobao.org'。若 npm 已經配置過,yarn 通常會沿用同一份設定,不必重複。
yarn 早期版本仍有零星問題,官方也在持續修,建議偶爾跑一次 yarn self-update。
以前鎖版本得用 npm shrinkwrap,流程繁瑣又難維護;yarn 自動生成 lock 檔,這點體驗差距明顯。
補充一個後續發展:npm 從 v5 起也內建了 package-lock.json,並在效能與確定性上大幅追近,yarn 也推出了 berry 版本(支援 PnP、不依賴 node_modules)。所以今天再選工具,更該看的是團隊既有慣例與 CI 環境,而非單純比較這份清單。