Monorepo中WebStorm代码补全失效是因多package.json导致作用域隔离，需在根及子项目tsconfig.json启用"composite":true并配置"references"，同时正确设置TypeScript路径别名与WebStorm库映射，并统一用tsc--build替代FileWatcher。
Monorepo 项目打开后代码补全失效，import 提示只显示子项目内内容
这是 WebStorm 对多 package.json 目录的默认识别逻辑导致的：一旦检测到 A/B/package.json，它就将 A/B 视为独立项目，自动隔离语言服务作用域，不再向上查找 A/src 中的类型定义。
常见错误现象包括：<template> 里输入 <CompA 没有提示、Ctrl+Click 跳转失败、TS2307 类型模块找不到错误。
- 不要删掉
A/B/package.json—— 这会破坏子项目可独立构建/测试的能力 - 在项目根目录（
A/）的tsconfig.json中启用"composite": true，并添加"references"显式声明依赖关系："references": [ { "path": "./B" }, { "path": "./src" } ] - 确保所有子项目（如
A/B/tsconfig.json）也设为"composite": true，否则 TypeScript 语言服务拒绝参与跨项目解析
WebStorm 不识别 @/ 或 @pkg1/ 别名，路径跳转和补全全挂
别名不是 WebStorm 自动理解的语法糖，它依赖两个独立配置源同时生效：TypeScript 的 baseUrl+paths 和 WebStorm 的「JavaScript Libraries」路径映射。缺一不可。
典型场景是 Vue + TS Monorepo，import utils from '@pkg1/utils' 在编辑器里标红，但 tsc --noEmit 却能通过。
- 在根
tsconfig.json中配置："baseUrl": ".", "paths": { "@pkg1/*": ["packages/pkg1/src/*"], "@/*": ["src/*"] } - 进
Settings > Languages & Frameworks > JavaScript > Libraries > Add...，把packages/pkg1/src和src都加为「Source Folders」 - 重启 WebStorm —— 路径映射不会热更新，不重启基本没用
File Watcher 编译子项目时反复触发、卡死或漏编译
Monorepo 下多个 tsconfig.json 共存时，若为每个子项目都配一个 File Watcher 并监听 **/*.ts，极易因文件系统事件嵌套触发（比如 A 编译输出 dist/index.js，又触发 B 的 Watcher）导致雪崩式重编。
根本原因在于 WebStorm 默认用 tsc -w 启动，而 tsc -w 本身不具备跨项目协调能力。
- 放弃为每个子项目单独配 Watcher；统一用根目录的
tsc --build驱动：Program: tsc Arguments: --build --verbose Working directory: $ProjectFileDir$
- 确保所有
tsconfig.json都含"composite": true，且根配置中"references"指向全部子项目 - 禁用 WebStorm 内置的 TypeScript Service（
Settings > Languages & Frameworks > TypeScript > Use TypeScript Service），避免与tsc --build冲突
子项目里改了代码，父项目引用处没更新补全或报错残留
这不是缓存问题，是 WebStorm 的 TypeScript 语言服务未感知到“被引用方”已变更。尤其当子项目用了 outDir 输出到非 node_modules 路径时，IDE 默认不监听其输出文件变化。
表现是：改了 packages/utils/src/index.ts，但在 packages/app/src/main.ts 里调用该函数时，仍提示旧参数签名或无定义。
- 在子项目
tsconfig.json中，把outDir设为相对路径（如"outDir": "../dist/utils"），并确保该路径不在exclude列表中 - 在父项目
tsconfig.json的"references"里，指向的是子项目的tsconfig.json路径，不是src目录 - 手动触发一次
File > Synchronize（快捷键Cmd+Alt+Y/Ctrl+Alt+Y），强制刷新文件系统状态
最常被忽略的一点：WebStorm 的「TypeScript language service」在 Monorepo 中默认只加载当前打开的 tsconfig.json 所属上下文，它不会主动扫描整个工作区的所有 references——必须靠 tsc --build 驱动 + 正确的 composite 配置，才能让它真正“看见”整个依赖图。
