Skip to main content

Turborepo CLI

Turborepo 的 CLI 提供了強大的任務執行與緩存管理功能。

常用指令​

執行任務​

最基本的用法是執行 turbo run <task>，這會根據 turbo.json 的定義來執行對應的 script。

# 執行所有 package 的 build 任務
turbo run build

# 執行所有 package 的 test 任務
turbo run test

# 同時執行多個任務
turbo run build test lint

參數說明​

Filter (--filter)​

使用 --filter 可以指定只對特定的 package 執行任務。

# 只執行 web-app 的 build
turbo run build --filter=web-app

# 執行 web-app 及其所有依賴的 build
turbo run build --filter=...web-app

# 執行 web-app 及其依賴它的所有 package 的 build
turbo run build --filter=web-app...

# 排除特定 package
turbo run build --filter=!ui-lib

Cache Control​

控制緩存的行為。

# 強制重新執行，忽略緩存
turbo run build --force

# 不使用緩存也不寫入緩存
turbo run build --no-cache

Parallel Execution​

# 平行執行任務（忽略拓撲依賴順序，需小心使用）
turbo run build --parallel

Graph Visualization​

生成任務依賴圖。

# 生成 dot 文件
turbo run build --graph

# 生成圖片 (需要安裝 graphviz)
turbo run build --graph=graph.png

更多資訊​

詳細的 CLI 參數可以參考官方文件：Turborepo CLI Reference