Angular 10通过npm link引入本地库时编译报错求助

遇到这个问题很常见，Angular 10对模块解析和符号链接（symlink）的处理比Angular 9更严格，结合你提供的配置，我整理了几个可行的解决方向：

1. 调整共享库的package.json，指向编译后的产物 #

你当前的共享库package.json中main字段指向的是源码文件src/index.ts，Angular 10的构建工具更期望链接的是已编译完成的库产物，而不是直接引用源码。

修改库的package.json：

{
  "name": "@mylib/shared-library",
  "version": "0.0.1",
  "main": "dist/index.js", // 改为编译后的入口文件
  "types": "dist/index.d.ts", // 新增类型文件入口，帮助TS识别类型
  // ... 其他配置不变
}

修改完成后，先在共享库目录执行ng build shared-library（如果是单库项目直接ng build）生成编译产物，再重新执行npm link。

2. 修正项目tsconfig.app.json的include路径 #

你当前在项目的tsconfig.app.json中包含了../../node_modules/@mylib/shared-library/**/*.ts，但npm link创建的symlink会让TS解析到本地库的真实路径，而不是node_modules下的虚拟路径，导致TS无法正确识别文件。

修改include字段为本地库的源码路径（根据你的项目结构调整相对路径）：

"include": [
  "src/**/*.d.ts",
  "../shared-library/src/**/*.ts" // 直接引用本地库源码，跳过symlink
]

这样TS会直接扫描库的源码文件，避免symlink带来的路径解析问题。

3. 完善tsconfig.base.json的符号链接配置 #

虽然你已经在angularCompilerOptions中设置了preserveSymlinks: true，但TypeScript本身的compilerOptions也需要开启这个选项，才能确保模块解析时保留symlink路径：

修改tsconfig.base.json：

"compilerOptions": {
  // ... 现有配置
  "preserveSymlinks": true // 新增这个配置
},
"angularCompilerOptions": {
  "fullTemplateTypeCheck": true,
  "strictInjectionParameters": true,
  "preserveSymlinks": true // 保持这个配置不变
}

这个选项会让TS和Angular构建工具尊重symlink的路径，而不是解析到真实文件路径，避免编译时找不到文件的问题。

4. 改用Angular官方推荐的本地库引用方式 #

npm link的symlink机制偶尔会和Angular的构建流程冲突，你可以尝试直接在项目中安装本地编译后的库：

1. 在共享库目录执行ng build shared-library --watch（实时编译库的修改）
2. 在项目目录执行npm install ../shared-library/dist/shared-library（根据你的库编译输出路径调整）
   这种方式比npm link更稳定，因为它直接引用编译后的文件，避免了symlink的路径解析问题。

5. 检查共享库的编译配置 #

确保你的库tsconfig.lib.json中的配置能正确生成可被项目识别的产物：

• 确认declaration: true：这个选项会生成.d.ts类型文件，帮助项目TS编译器识别库的类型
• 确认outDir路径正确：确保编译产物输出到指定目录，并且package.json中的main和types字段指向该目录下的文件

尝试以上方法后，重新启动项目的构建服务（ng serve），应该能解决这个编译错误。

内容的提问来源于stack exchange，提问作者Sergino