WebStorm中Attach Directory与Add Content Root本质相同，但新版已统一为File→Attach Directory…；旧版右键提示的“Add Content Root”实为跳转入口。
WebStorm 不能在一个窗口里真正“并列”打开多个独立项目——所谓“多项目共存”，本质是主项目 + 若干附加目录，共享索引、Git 根、运行配置和 .idea 状态。真要隔离，得开多个实例。
Attach Directory 和 Add Content Root 是一回事吗？
是，但菜单路径变了：新版 WebStorm（2023.3+）已移除 Add Content Root 菜单项，统一用 File → Attach Directory…。右键项目根目录看到的 “Add Content Root” 是旧版残留提示，点它会跳转到 Attach Directory 对话框。
- 选错路径会导致子目录被重复挂载，
.idea/modules.xml里出现冗余<module></module>，可能引发代码补全失效或 import 解析错误 - 挂载后不会自动识别
package.json或tsconfig.json；必须手动右键该目录 →Mark Directory as → Sources Root，否则类型检查、跳转、重构都不可靠 - 如果附加目录本身是 Git 仓库，WebStorm 默认仍以主项目的
.git为根，Git tool window不显示附加目录的变更——除非你手动在VCS → Git → Repositories里添加它
为什么 npm run dev 在附加项目里报 “command not found”？
因为 WebStorm 的 npm 运行配置默认工作目录（Working directory）锁定在主项目根，不会随你当前编辑的文件自动切换。
- 必须手动新建一个
npm配置：点击Run → Edit Configurations… → + → npm - 在新配置中显式设置
Package.json路径（指向附加项目的package.json），并把Working directory改成该目录路径 - 不这么做，即使你在附加项目里双击
package.json的 script 行，执行时也还是跑主项目的node_modules，容易因依赖版本差异导致启动失败
开多个 WebStorm 实例真的更稳？
对，尤其当你同时处理技术栈差异大的项目（比如 Vue 3 + Vite 和 NestJS + Monorepo）时，多实例是唯一能避免冲突的方式。
- macOS：终端执行
open -n -a "WebStorm"，每次都会启新进程；可保存为脚本或 Alfred 快捷方式 - Windows：快捷方式目标加参数
"C:\Program Files\JetBrains\WebStorm 2025.1\bin\webstorm64.exe" --new-instance - Linux：启动命令末尾加
--new-instance - 每个实例独占内存、插件状态、索引缓存和
.idea/workspace.xml，不会出现“改了 A 项目设置，B 项目自动同步出错”的情况
最常被忽略的一点：附加目录模式下，Find in Path（Ctrl+Shift+F）默认只搜主项目，必须手动勾选 “All Places” 并确认搜索范围包含你挂载的目录——否则你会以为代码没被索引，其实是搜错了范围。
