VSCode中turbo命令不识别的根本原因是终端未加载项目node_modules/.bin路径，尤其monorepo下turbo仅装于根目录而shell未包含该路径；需配置终端shell、添加PATH或用npx turbo，同时正确设置tasks.json、tsconfig.paths及turbo.json的inputs/outputs。
VSCode里turbo命令不识别，turbo报“command not found”
根本原因是 VSCode 终端没加载你项目里 node_modules/.bin 的可执行文件，尤其在用 pnpm/yarn 管理 monorepo 时，turbo 默认只装在根 node_modules，但 shell 路径没自动包含它。
实操建议：
- 在 VSCode 设置里搜
terminal.integrated.defaultProfile，确保终端启动的是你日常用的 shell（比如 zsh 或 bash），不是 Windows PowerShell（Windows 用户常踩这个坑） - 在项目根目录下运行
npx turbo --version验证 turbo 装好了；如果成功，说明问题纯属路径没导进去 - 把
node_modules/.bin加进终端启动配置：比如 macOS/Linux 在~/.zshrc末尾加export PATH="./node_modules/.bin:$PATH"（⚠️注意是当前目录，不是全局）；更稳妥的做法是用npx turbo替代直接敲turbo
想在VSCode里点一下就跑turbo run build，怎么配任务？
VSCode 的 tasks.json 可以绑定 turbo 命令，但别硬写绝对路径或假设全局安装——monorepo 里 turbo 版本、工作目录、包依赖都得对齐。
实操建议：
- 在项目根目录建
.vscode/tasks.json，内容用type: "shell"+command: "npx turbo run build"，避免依赖 PATH -
group设成"build"，这样按Cmd/Ctrl+Shift+B就能唤出构建菜单 - 如果要针对某个包运行（比如只构建
packages/ui），加--scope=ui参数：npx turbo run build --scope=ui - 别在
tasks.json里写dependsOn跨包任务——turbo 自己靠turbo.json的pipeline定义依赖，VSCode 任务不参与拓扑解析
Ctrl+Click跳转到包内依赖失败，比如点 import { foo } from 'my-utils' 没反应
这是 TypeScript + monorepo 最常见的符号解析断裂。VSCode 默认按 node_modules 查找，但 turborepo 里的本地包（如 my-utils）通常通过 workspace 协议或 path mapping 暴露，TS 语言服务不知道去哪找源码。
实操建议：
- 确认根目录有
tsconfig.base.json或类似基础配置，并在各包的tsconfig.json里用"extends": "../tsconfig.base.json" - 在
tsconfig.base.json中配好compilerOptions.paths，例如："my-utils": ["packages/my-utils/src"]，路径必须相对于baseUrl - 删掉所有包下的
node_modules和package-lock.json（如果是 pnpm，保留pnpm-lock.yaml），然后重装依赖 —— 否则 TS 可能缓存了旧的 resolve 结果 - VSCode 右下角点 TypeScript 版本，选 “Use Workspace Version”，确保用的是项目里装的 TS，不是全局那个
修改一个包后，turbo run dev 没触发下游包重建
turbo 的缓存和增量构建完全依赖 turbo.json 里 pipeline 的输入/输出声明，以及实际文件变更是否落在声明范围内。常见情况是：改了代码，但 turbo 没当回事，因为没告诉它“这个文件变了就得重跑”。
实操建议：
- 检查
turbo.json中对应 task 的inputs是否包含源码目录，比如"build": { "inputs": ["src/**", "package.json"] }；漏掉tsconfig.json或lib/**都可能导致失效 - 确认被依赖的包在
outputs里声明了产物路径，例如"outputs": ["dist/**", ".next/**"]；否则 turbo 不知道该缓存啥、比对啥 - 用
npx turbo run build --dry-run看它实际打算跑哪些包，比盲目猜更准 - 如果用了
pnpm的workspace:协议，确保package.json里依赖写的是"my-utils": "workspace:^"，而不是固定版本号 —— 否则 turbo 无法建立包间拓扑关系
真正卡住的地方往往不是 turbo 本身，而是 turbo.json 的 inputs/outputs 和实际工程结构没对齐，或者 TypeScript 路径映射和 package.json 的 exports 字段互相打架。调一次 --dry-run，再看一眼 dist 目录有没有生成，比查十篇文档都管用。
