webstorm 单实例无法真正支持多 lerna 包：附加目录不继承 node_modules 索引、git 根、运行配置等，导致类型提示失效、调试路径错误；最稳方案是每个包单独启动 webstorm 实例。
WebStorm 里直接开多个 Lerna 包会出什么问题
不能真当“多项目”用——WebStorm 的 Project 模型只认一个根目录，所谓“挂载多个包”实际是 File → Attach Directory…，但附加目录不会自动获得：node_modules 索引、package.json 解析、Git 根识别、运行配置上下文。你改 packages/a 里的代码，packages/b 的 import 提示可能全失效；调试时选错 Working directory，process.cwd() 指向主项目根，导致路径错误或找不到 tsconfig.json。
怎么让每个 Lerna 包在 WebStorm 里独立获得完整支持
最稳的方案是：每个包单独开一个 WebStorm 实例，而不是塞进同一个窗口。这样每个实例独占索引、插件状态、Git 配置和 Node.js 运行环境。
- macOS：终端执行
open -n -a "WebStorm" --args packages/a - Windows：快捷方式目标加参数
"C:\Program Files\JetBrains\WebStorm 2025.1\bin\webstorm64.exe" --new-instance packages\a - Linux：启动命令末尾加
--new-instance packages/a
注意别用 File → Open 打开子目录——那会关闭当前项目并加载新根，不是新开窗口；也别依赖 Attach Directory 后手动 Mark as Sources Root，它解决不了依赖推导和运行时路径问题。
Lerna 包之间 import 跳转和类型提示为啥不工作
核心原因是 WebStorm 默认只索引最外层 node_modules，而 Lerna 的本地 link（比如 npm link 或 pnpm link）或 workspaces 声明，不会被自动识别为源码路径。即使你在 packages/a 里写了 import { foo } from '@myorg/b'，IDE 也不知道 @myorg/b 对应哪个文件夹。
- 确保根
package.json有"workspaces": ["packages/*"]（Lerna v7+ 推荐用 pnpm 或 npm workspaces 替代 lerna bootstrap） - 在 WebStorm 中打开的是整个 monorepo 根目录（不是某个
packages/xxx），然后手动触发Reload project from disk（右键根目录 → “Reload project from disk”） - 检查
Settings → Languages & Frameworks → JavaScript → Libraries，确认没有误删或禁用packages下的源码路径 - 如果用 TypeScript，确保每个包都有自己的
tsconfig.json，且compilerOptions.baseUrl和paths配置正确，否则跳转会 fallback 到node_modules里的声明文件
运行和调试 Lerna 子包脚本的正确姿势
WebStorm 不会自动把 packages/a/package.json 里的 scripts 映射成可运行配置。你点 “Add Configuration → npm”，默认 Package.json 路径指向根目录，Command 是 run，Scripts 下拉里根本看不到 a 包的脚本。
- 新建
npm运行配置后，必须手动修改Package.json字段为packages/a/package.json -
Working directory必须设为$ProjectFileDir$/packages/a，否则npm run dev会去根目录找webpack.config.js或vite.config.ts - 如果脚本依赖本地 linked 包（如
@myorg/b），确保已执行过npx lerna bootstrap或pnpm install，否则运行时抛Cannot find module '@myorg/b' - 调试时，断点打在
packages/a里却没命中？检查 Chrome DevTools 的 “Sources” 面板是否加载了正确的 sourcemap 路径，常见原因是devtool: 'source-map'没开启或output.devtoolModuleFilenameTemplate指向了绝对路径
真正麻烦的从来不是怎么配，而是 WebStorm 把“单项目 IDE”的设计逻辑强加给 monorepo 场景——它不认为 packages/a 和 packages/b 是对等实体，只把它们看作“主项目的子目录”。所以所有绕开这个前提的配置，最终都会在 Git 状态、依赖解析或调试路径上漏一两个缝。
