webstorm 识别不了 turbo 命令需三步解决：一是在项目根目录安装 turbo（pnpm add turbo --save-dev）；二是 run configuration 中 node interpreter 选“project default”或指向 node_modules/.bin；三是确保 turbo.json 放在项目根目录、用 "tasks" 而非 "pipeline" 字段。
WebStorm 识别不了 turbo 命令？先确认 CLI 安装方式
WebStorm 默认不自动继承全局 shell 环境的 pnpm 或 turbo，所以你在终端里能跑 turbo build，但在 WebStorm 的 Run Configuration 里点运行却报 Command 'turbo' not found——这是最常见卡点。
- 别只装全局
turbo：pnpm add turbo --global对 WebStorm 的 Node.js 运行环境无效；必须在项目根目录下也装：pnpm add turbo --save-dev - Run Configuration 中的 Node interpreter 要指向项目级
node_modules/.bin路径，或直接选「Project default」（前提是项目已用 pnpm 初始化且node_modules存在） - 如果用了 pnpm，确保 WebStorm 的 Terminal 设置里启用了
Use login shell（Settings → Tools → Terminal），否则pnpx turbo可能找不到 pnpm 的 bin 目录
turbo.json 放错位置或格式错误，WebStorm 不会报错但任务不生效
WebStorm 不校验 turbo.json 语义，只把它当普通 JSON 文件。你改了 tasks.dev.cache 为 false，但 dev 任务仍被缓存？大概率是配置没生效。
-
turbo.json必须放在**项目根目录**（即含pnpm-workspace.yaml的那层），不是某个 package 下 - 字段名必须严格匹配：
"pipeline"是旧版 Turborepo（v1.x）写法，v2+ 已废弃，新版只认"tasks"；写成"pipeline"会导致整个配置静默失效 -
"inputs"和"outputs"路径支持 glob，但不支持变量展开（如$TURBO_DEFAULT$是合法的，但${PWD}不行）；路径错误会导致缓存始终 miss
在 WebStorm 里运行 turbo dev 却卡住不动？检查 persistent 和端口冲突
turbo dev 设为 "persistent": true 后，WebStorm 的 Run Tool Window 会持续监听输出，但如果你看到光标停在最后一行、无响应，不是 Turbo 挂了，而是它在后台持续运行 —— 但 WebStorm 没把 stdout 正确流式渲染出来。
- 确保
dev任务里没漏掉"cache": false：否则 WebStorm 可能复用上一次的缓存输出，看起来像“没重启” - 多个
dev服务（比如web和docs）默认都占3000端口，WebStorm 并不会帮你做端口探测；手动在turbo.json的dev配置里加"env": ["PORT=3001"]避免冲突 - 若用
pnpm run dev包一层，记得在 package.json script 里加--if-present或用concurrently，否则 WebStorm 会等第一个进程退出才启动下一个
想让 WebStorm 自动高亮 turbo 相关脚本并跳转？靠文件关联和插件补足
WebStorm 原生不识别 turbo.json 里的任务名，所以你 Ctrl+Click build 不会跳到对应 package 的 package.json#scripts.build —— 这不是 bug，是设计如此。
- 手动关联：Settings → Editor → File Types → 「JSON files」→ 在 Registered Patterns 里加
turbo.json，再给它绑定一个更智能的 schema（用"$schema": "https://turborepo.com/schema.json"可触发基础校验） - 安装插件
JSON Schema Validator（JetBrains 官方插件），然后在turbo.json顶部加注释// @schema https://turborepo.com/schema.json，就能获得字段提示和错误标记 - 对
pnpm run脚本，启用 Settings → Languages & Frameworks → JavaScript → Libraries → Enable auto-import for scripts，可让 WebStorm 把pnpm run build和对应 package 的scripts.build建立软链接
真正麻烦的是跨 workspace 的依赖链：比如 ui 库改了，web 的 turbo build 应该自动重跑，但 WebStorm 不感知这种拓扑。得靠 "dependsOn": ["^build"] 写对，且所有 workspace package 的 name 字段不能重复 —— 这个细节一旦错，Turbo 就不会向上查找依赖，而 WebStorm 完全不会提醒你。
