WebStorm下Angular多项目模板无法解析继承自公共库的属性如何解决

问题原因 #

这个报错是WebStorm静态类型分析的局限性导致的：你当前配置的my-library路径别名优先指向dist目录下的库编译产物，WebStorm对编译后.d.ts文件的多层继承链解析经常出现识别失败的问题，所以只能解析到当前项目内定义的propertyB和propertyC，无法识别库中定义的父类属性propertyA。
你测试用长相对路径直接导入库源码能识别，就是因为IDE直接解析了源码的类型，而非编译后的d.ts文件，但这种写法违反了Angular多项目工作区的依赖规则，确实会导致编译失败。

解决方案 #

按优先级依次尝试以下方法即可：

1. 调整路径别名优先级，让IDE优先解析库源码
   修改根目录tsconfig.json的paths配置，把库的源码入口放在最前面，dist路径放在后面：

"paths": {
  "my-library": ["projects/my-library/src/public-api.ts", "dist/my-library/my-library", "dist/my-library"],
  "@my-project/*": ["projects/my-project/src/*"]
}

如果担心编译时读源码导致问题，可以在projects/my-project/tsconfig.app.json中单独覆写paths配置，让编译阶段依然优先读取dist产物：

"paths": {
  "my-library": ["dist/my-library/my-library", "dist/my-library"]
}

2. 修正WebStorm的TypeScript配置

• 打开WebStorm设置 → 语言和框架 → TypeScript，确认「TypeScript版本」选择的是项目本地的版本，且勾选了「从tsconfig.json获取配置」
• 右键点击根目录的tsconfig.json，选择「标记为TypeScript配置文件」
• 清空缓存重启IDE：顶部菜单栏选择「文件 → 清除缓存...」，勾选清除文件系统缓存后重启WebStorm

3. 确保库的构建产物完整
   每次修改my-library的代码后，先执行ng build my-library生成最新的编译产物和类型声明文件，避免dist目录下的.d.ts文件过时导致解析失败。
4. 添加工作区依赖关联
   在根目录package.json的dependencies中添加本地库的 workspace 引用，帮助IDE识别包的来源：

"dependencies": {
  "my-library": "workspace:*",
  // 其他依赖保持不变
}

内容的提问来源于stack exchange，提问作者Lou-Théo