monorepo + Turborepo --- 运行任务
目录
在 package.json 中使用 scripts
自动包作用域
自定义行为
运行多个任务
使用过滤器
按包筛选
按目录筛选
筛选以包含依赖项
按源代码控制更改筛选
组合过滤器
Turborepo 通过自动并行化和缓存任务来优化你仓库中的开发者工作流程。一旦任务在 turbo.json 中注册，你就拥有了一个强大的新工具集，用于运行你仓库中的脚本
- 对于你需要经常运行的任务，请在 package.json 中使用 scripts
- 使用全局 turbo 快速按需运行自定义任务
- 按目录、包名、源代码控制更改等筛选任务
- 通过 turbo 运行任务非常强大，因为你获得了一个模型，用于在整个仓库的开发和 CI 管道中执行工作流程。
在 package.json 中使用 scripts
对于你经常运行的任务，你可以将 turbo 命令直接写入你的根目录 package.json 中。
{"scripts": {"dev": "turbo run dev","build": "turbo run build","test": "turbo run test","lint": "turbo run lint"}
}须知：
turbo是turbo run的别名 - 但我们建议在package.json和 CI 工作流程中使用turbo run，以避免与未来可能添加的turbo子命令发生潜在冲突。
这些脚本随后可以使用你的包管理器运行。
pnpm dev你只能在你的根目录
package.json中编写turbo命令。在包的package.json中编写turbo命令可能会导致递归调用turbo。
自动包作用域
当你在一个包的目录中时，turbo 将自动将命令的作用域限定为该包的 包图。这意味着你可以快速编写命令，而无需为该包 编写过滤器。
cd apps/docs
turbo build在上面的示例中，turbo build 命令将使用在 turbo.json 中注册的 build 任务，为 docs 包运行 build 任务。
须知： 使用过滤器 将覆盖自动包作用域。
自定义行为
在 run 子命令的文档 中，你将找到许多有用的标志，可以根据你的需要定制 turbo run 的行为。当运行全局 turbo 时，你可以使用如下工作流程更快地运行：
你最常用命令的变体：package.json 中的 build 脚本在它是 turbo build 时最有用 - 但你可能目前只对特定包感兴趣。你可以使用 turbo build --filter=@repo/ui 快速筛选出你感兴趣的特定包。
一次性命令：像 turbo build --dry 这样的命令不常用，因此你可能不会在你的 package.json 中为其创建脚本。相反，你可以在需要时随时在终端中直接运行它。
覆盖 turbo.json 配置：某些 CLI 标志在 turbo.json 中具有等效项，你可以覆盖它们。例如，你可能已配置 turbo build 命令以在 turbo.json 中使用 "outputLogs": "full" - 但你目前只对查看错误感兴趣。使用全局 turbo，你可以使用 turbo lint --output-logs=errors-only 仅显示错误。
{"tasks": {"build": {"outputLogs": "new-only"}}
}
运行多个任务
turbo 能够运行多个任务，并在可能的情况下进行并行化。
turbo run build test lint check-types任务排序
turbo test lint将以与turbo lint test完全相同的方式运行任务。如果你想确保一个任务阻止另一个任务的执行，请在你的 任务配置 中表达这种关系。
使用过滤器
虽然 缓存 确保你保持快速，永不重复相同的工作，但你也可以筛选任务，仅运行 任务图 的子集。
在 --filter API 参考 中，有很多高级用例用于过滤，但下面讨论最常见的用例。
按包筛选
按包筛选是一种简单的方法，仅为你当前正在处理的包运行任务。
turbo build --filter=@acme/web你还可以直接在你的 CLI 命令中为包筛选特定任务，而无需使用 --filter
# Run the `build` task for the `web` package
turbo run web#build# Run the `build` task for the `web` package, and the `lint` task for the `docs` package
turbo run web#build docs#lint按目录筛选
你的仓库可能具有目录结构，其中相关的包被分组在一起。在这种情况下，你可以捕获该目录的 glob 模式，以将 turbo 聚焦于这些包。
turbo lint --filter="./packages/utilities/*"
筛选以包含依赖项
当你在处理特定包时，你可能想要为该包及其依赖项运行任务。当你更改包并希望确保更改不会破坏其任何依赖项时，... 微语法很有用。
turbo build --filter=...ui按源代码控制更改筛选
使用过滤器根据源代码控制中的更改运行任务是仅为受你的更改影响的包运行任务的好方法。源代码控制过滤器必须用 [] 括起来。
- 与上一个提交比较：turbo build --filter=[HEAD^1]
- 与主分支比较：turbo build --filter=[main...my-feature]
- 使用 SHA 比较特定提交：turbo build --filter=[a1b2c3d...e4f5g6h]
- 使用分支名称比较特定提交：turbo build --filter=[your-feature...my-feature]
通常，你可以依靠缓存来保持你的仓库快速。当你在使用 远程缓存 时，你可以指望为未更改的包命中缓存。
组合过滤器
为了获得更高的特异性，你可以组合过滤器以进一步细化进入你的 任务图 的入口点。
turbo build --filter=...ui --filter={./packages/*} --filter=[HEAD^1]多个过滤器组合为并集，这意味着 任务图 将包括与任何过滤器匹配的任务。有关过滤器高级用法的更多信息，请参阅 --filter API 参考。