vscode终端报turbo command not found是因path未包含node_modules/.bin，解决方法包括：在shell配置中添加export path="./node_modules/.bin:$path"、用npx turbo替代全局调用、正确配置tasks.json和tsconfig.base.json并重启ts server。

turbo 命令在 VSCode 终端里报 command not found，不是 Turbo 没装，而是 VSCode 没找到它——根本原因在于终端没加载项目根目录下的 node_modules/.bin，尤其在 pnpm/yarn monorepo 中，turbo 只装在根 node_modules，而 shell 启动时 PATH 里压根不含这个路径。

VSCode 终端找不到 turbo 怎么办

这不是安装问题，是环境路径没对齐。VSCode 启动终端时用的是系统默认 shell 配置，不会自动把当前项目 node_modules/.bin 加进 PATH。

• 先在终端里运行 npx turbo --version，如果能输出版本号，说明 turbo 确实装好了，纯属 PATH 缺失
• 检查 VSCode 设置里 terminal.integrated.defaultProfile 是否指向你日常用的 shell（比如 zsh 或 bash），Windows 用户常误设成 PowerShell，导致 profile 文件（如 ~/.zshrc）不生效
• 别改全局 PATH，直接在项目根目录的 .zshrc（或 .bashrc）末尾加：export PATH="./node_modules/.bin:$PATH"（注意是 ./，不是 $PWD/ 或绝对路径）
• 更稳妥的做法：所有 VSCode 任务都用 npx turbo，绕过 PATH 依赖

怎么在 VSCode 里一键运行 turbo run build

别硬写 turbo 命令，也别假设它全局可执行。VSCode 的 tasks.json 必须适配 monorepo 的实际结构：工作目录、包范围、turbo 版本都得对齐。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在项目根目录建 .vscode/tasks.json，type 设为 "shell"，command 写 "npx turbo run build"
• group 设成 "build"，这样按 Ctrl+Shift+B（macOS 是 Cmd+Shift+B）就能唤出构建菜单
• 要只构建某个包，比如 packages/ui，加 --scope=ui 参数：npx turbo run build --scope=ui
• 别在 dependsOn 里写跨包依赖——turbo.json 的 pipeline 才管依赖拓扑，VSCode 任务只负责触发

为什么 Ctrl+Click 跳转本地包失败

不是 VSCode 不行，是 TypeScript 语言服务压根不知道 my-utils 这种包名该去哪找源码。monorepo 里没有 node_modules/my-utils 的真实目录，只有 workspace 映射或 path alias。

• 必须用根目录打开整个 monorepo（路径含 pnpm-workspace.yaml 或 turbo.json），否则 TS Server 只看到子目录，完全看不到其他包
• 根目录要有 tsconfig.base.json，里面配好 compilerOptions.baseUrl 和 paths，例如："my-utils": ["packages/my-utils/src"]
• 每个子包的 tsconfig.json 必须 "extends": "../tsconfig.base.json"，且含 "composite": true
• 改完配置后，必须手动执行 Developer: Restart TS Server（命令面板里搜），否则旧缓存还在生效

构建慢？先看 turbo.json 的 inputs 和 outputs

缓存失效频繁，八成是 inputs 漏了关键文件，或 outputs 没覆盖真实产物。Turborepo 的缓存键基于这些字段 + 文件内容哈希生成，差一点就全盘重跑。

• inputs 至少包含："src/**/*.ts"、"package.json"、"tsconfig.json"；如果用了自定义构建脚本，也得加进去
• outputs 必须精准匹配实际输出目录，比如 "dist/**" 或 "build/**"，别写成 "./dist"（开头带点会失效）
• 避免把 node_modules 或 .git 放进 inputs——它们不该影响缓存决策
• CI 环境建议启用远程缓存，但本地开发先确保 .turbo/cache 目录没被 .gitignore 错误排除

真正卡住人的地方，往往不是 Turbo 本身，而是 VSCode 的 TS Server 没刷新、终端 PATH 没生效、或者 inputs 里漏了一个 webpack.config.js ——这些细节不验证，再快的 Rust 构建器也白搭。