開發人員入門

先決條件

若要使用 Rush，您需要 NodeJS 引擎。我們建議使用最新的LTS 版本，因為不穩定的 NodeJS 版本經常有錯誤。您可以考慮透過nvm-windows 或 nvm (Mac/Linux) 進行安裝，這可讓您輕鬆切換不同專案可能需要的不同 NodeJS 版本。

您也需要安裝 Rush 工具本身。這非常簡單。從您的 Shell 或命令提示字元中，輸入以下內容

npm install -g @microsoft/rush

注意：如果因為您的使用者帳戶沒有存取 NPM 全域資料夾的權限而導致此命令失敗，您可能需要修正您的 NPM 組態。

若要查看 Rush 的命令列說明，您可以輸入

rush -h

命令列說明也會線上發佈在命令參考中。

一些注意事項

在開始之前，請記住幾個重點

1. 避免在 Rush 儲存庫中使用某些命令

Rush 的最佳化方式是將所有相依性套件安裝在中央資料夾中，然後使用符號連結，為每個專案建立「node_modules」資料夾。

避免使用會安裝/連結相依性的套件管理員命令。例如，npm run 可以正常運作，但這些命令會因 Rush 的符號連結而感到困惑：npm install、npm update、npm link、npm dedupe 等。(其他套件管理員也是如此：避免使用 pnpm install 或 yarn install 之類的命令。) 如果您想使用這些命令，請先執行 rush unlink，刪除 Rush 建立的符號連結。

如果您使用 git clean -dfx 清理資料夾，請注意它會不適當地處理符號連結。為避免發生問題，請在執行 git clean -dfx 之前，務必執行 rush unlink。

之後，您可以執行 rush update 重新建立符號連結。(有一個獨立的 rush link 命令，但很少需要。)

2. 如果您懷疑安裝損毀...

Rush 的套件管理命令是「增量」的，這表示它們會略過看起來不必要的步驟，藉此節省時間。由於 Rush 在自動化的建置環境中執行，因此我們有許多保護措施可確保這些檢查是準確的。但是，當您在本機電腦上對套件進行偵錯或調整時，有時您的 NPM 「node_modules」資料夾可能會進入錯誤的狀態，導致發生奇怪的錯誤。

如果您懷疑安裝損毀，請嘗試執行 rush update --purge。這會強制完整重新安裝您的套件，通常會讓您回到良好的狀態。