WebStorm在多模块项目中无法识别子模块依赖，因其默认仅解析根目录的package.json；需手动标记子模块目录为Node.js/Maven模块，配置tsconfig.json的composite、references及paths映射，并刷新缓存。
WebStorm 在多模块项目里识别不了依赖关系，不是代码写错了，而是它根本没把子模块当“可解析的模块”来看——哪怕 package.json 都在，它也可能只扫根目录，忽略子包。
为什么 Dependencies 节点里看不到子模块？
WebStorm 的 Dependencies 节点默认只认项目根目录下的 package.json 或 pom.xml。子模块（比如 packages/utils）即使有自己独立的 package.json，也不会自动被纳入依赖树——除非你手动告诉 WebStorm：“这个目录也是个模块”。
- 右键子模块目录（如
packages/utils）→ Mark Directory as → 勾选Node.js（或Maven） - 如果子模块是 TypeScript 项目，还需确保其
tsconfig.json存在且含"compilerOptions": { "composite": true }，否则 WebStorm 不会索引它的导出 - 若子模块用
workspace:协议引用（如"my-utils": "workspace:^1.0.0"），WebStorm 2025.2+ 才支持解析；老版本需手动添加node_modules/my-utils为库路径（Settings > Languages & Frameworks > JavaScript > Libraries）
子模块 import 跳转失效或标红
跳转失败不是路径问题，而是 WebStorm 没把当前文件和子模块的类型系统对齐。常见于 pnpm monorepo 中子包未启用 ESM 或类型声明缺失。
- 检查子模块
package.json是否含"type": "module"；没有就加，否则 WebStorm 默认按 CommonJS 解析import - 确认子模块输出字段正确：
"main": "lib/index.js"、"types": "lib/index.d.ts"、"exports"若存在，必须包含"./index"等有效入口 - 根目录
tsconfig.json中需有"references"字段，显式列出子模块路径："references": [{ "path": "./packages/utils" }] - 删掉
node_modules后，必须先跑pnpm install再重启 WebStorm——否则.pnpm软链接不全，子模块路径解析直接失败
运行时依赖能加载，但 IDE 里提示 “Unresolved variable”
这说明运行环境（Node.js/Vite）能找到模块，但 WebStorm 的静态分析没打通路径映射。尤其在用了 @/、~/ 这类别名时最典型。
- 别只配
vue.config.js或vite.config.ts—— WebStorm 不读这些构建配置。必须在jsconfig.json或tsconfig.json里配"baseUrl"和"paths"：
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"utils/*": ["packages/utils/src/*"]
}
}
File > Invalidate Caches and Restart > Invalidate and Restart，否则缓存会沿用旧映射pnpm 的 peerDependency 提升机制，某些包可能不在子模块 node_modules 里，WebStorm 就会标红；此时需在子模块 package.json 中显式声明该依赖（哪怕只是 devDependencies）真正麻烦的不是配置本身，而是 WebStorm 对多模块项目的“信任边界”很窄：它不会自动推断子模块是否参与类型检查、是否导出可被引用的 API。每个子模块都得单独“注册”，每条路径映射都得手动喂给 IDE，漏一个环节，整个链路就断在编辑器里——而运行时完全正常，这种错位最容易让人反复怀疑代码。
