如何配置Turborepo的watch模式？pnpm monorepo排障

1. 强制Dev任务等待所有依赖构建完成 #

在turbo.json的dev任务中添加waitForDependencies: true配置，确保Turbo在启动持久化的dev服务前，完全完成所有依赖的build任务：

{
    "$schema": "https://turbo.build/schema.json",
    "tasks": {
        "build": {
            "dependsOn": ["^build"],
            "outputs": ["dist/**"]
        },
        "dev": {
            "dependsOn": ["^build"],
            "persistent": true,
            "cache": false,
            "waitForDependencies": true
        }
    }
}

默认情况下，持久化任务（persistent: true）可能不会等待所有依赖前置任务彻底完成就启动，这是导致依赖未构建完成就启动Webpack Dev服务的核心原因。

2. 明确指定包管理器 #

在turbo.json根节点添加packageManager字段，确保Turbo使用pnpm的依赖解析逻辑，避免和pnpm workspace的依赖图产生偏差：

{
    "$schema": "https://turbo.build/schema.json",
    "packageManager": "pnpm@8.15.0", // 替换为你实际使用的pnpm版本
    "tasks": {
        // ... 现有任务配置
    }
}

3. 精准过滤目标应用及其依赖 #

运行turbo watch时使用--filter参数，明确指定要处理的Webpack应用及其所有依赖，减少复杂层级带来的调度混乱：

turbo watch dev --filter=your-webpack-app...

其中...表示包含目标应用的所有递归依赖，Turbo会更精准地按照依赖顺序执行构建任务。

4. 显式声明Build任务为非持久化 #

虽然build任务默认是persistent: false，但显式声明可以避免watch模式下的潜在调度异常：

"build": {
    "dependsOn": ["^build"],
    "outputs": ["dist/**"],
    "persistent": false
}

内容的提问来源于stack exchange，提问作者Steve B