nx-run-tasks

你可以用下列方式透過 Nx 執行任務。

請記住，如果使用者沒有全域安裝 nx，你可能需要在指令前加上 npx/pnpx/yarn。請查看 package.json 或 lockfile 來判斷使用的是哪個套件管理器。

如需任何指令的更多詳細資訊，請加上 --help 執行（例如 nx run-many --help、nx affected --help）。

了解可以執行哪些任務

你可以透過 nx show project <projectname> --json 來檢查，例如 nx show project myapp --json。其中包含 targets 區段，提供可執行目標的資訊。你也可以直接查看 package.json 的 scripts 或 project.json 的 targets，但你可能會漏掉 Nx 外掛推斷出的任務。

執行單一任務

nx run <project>:<task>

其中 project 是在 package.json 或 project.json（如果有的話）中定義的專案名稱。

執行多個任務

nx run-many -t build test lint typecheck

你可以加上 -p 旗標來篩選特定專案，否則會在全部專案上執行。你也可以使用 --exclude 來排除專案，以及使用 --parallel 來控制平行處理的數量（預設為 3）。

範例：

• nx run-many -t test -p proj1 proj2 — 測試特定專案
• nx run-many -t test --projects=*-app --exclude=excluded-app — 測試符合模式的專案
• nx run-many -t test --projects=tag:api-* — 依標籤測試專案

為受影響的專案執行任務

使用 nx affected 只對已變更的專案以及依賴這些變更專案的專案執行任務。這在 CI 和大型工作區中特別有用。

nx affected -t build test lint

預設會與基底分支比較。你可以自訂：

• nx affected -t test --base=main --head=HEAD — 與特定的基底和 head 比較
• nx affected -t test --files=libs/mylib/src/index.ts — 直接指定變更的檔案

實用的旗標

這些旗標適用於 run、run-many 和 affected：

• --skipNxCache — 即使結果已快取，仍重新執行任務
• --verbose — 列印額外資訊，例如堆疊追蹤
• --nxBail — 在第一個任務失敗後停止執行
• --configuration=<name> — 使用特定設定（例如 production）