将本地库链接到Angular 5项目遇问题：无法找到指定模块

先别急，我之前踩过几乎一模一样的坑，给你梳理几个容易遗漏的关键步骤，按顺序试一遍应该能搞定：

• 先确保本地库已经完成构建
  Angular库不是直接link源码就能用的，必须先编译成可分发的产物。进入你的本地angular-oauth2-oidc库目录，执行构建命令：

  ng build angular-oauth2-oidc
  

  构建完成后，库的根目录会生成dist/angular-oauth2-oidc文件夹，里面才是项目能识别的编译后代码。很多人跳过这一步直接link源码，自然会出现找不到模块的错误。

• 检查库的package.json名称是否匹配
  确认库根目录的package.json里的name字段确实是angular-oauth2-oidc——npm link是根据这个名称建立关联的，如果名称写错了，哪怕link成功，项目也找不到对应模块。

• 正确配置tsconfig的路径映射
  路径配置要指向编译后的dist目录，而不是源码目录。修改项目根目录的tsconfig.json（注意不是tsconfig.app.json），在compilerOptions里添加：

  "paths": {
    "angular-oauth2-oidc": ["../path-to-your-local-library/dist/angular-oauth2-oidc"]
  }
  

  这里的../path-to-your-local-library要替换成你本地库相对于项目的实际路径。如果是Angular 12+版本，可能还需要在tsconfig.app.json里同步这个路径配置，确保编译器能找到类型文件。

• 开启Angular的符号链接支持
  Angular CLI默认可能会忽略符号链接的模块，需要在angular.json里开启preserveSymlinks配置。找到你项目的architect.build.options，添加：

  "build": {
    "options": {
      "preserveSymlinks": true,
      // 其他原有配置...
    }
  }
  

  这个配置能让CLI正确解析通过npm link创建的符号链接模块。

• 清理缓存并重启服务
  有时候Angular的缓存会干扰模块解析，执行以下命令清理缓存：

  ng cache clean
  

  然后彻底关闭当前的ng serve进程，重新启动服务。如果还是不行，可以尝试删除项目的node_modules和package-lock.json，重新执行npm install后再重新link一次库。

• 检查库的类型文件是否存在
  确保库构建时生成了.d.ts类型文件——Angular是TypeScript项目，没有类型文件也会触发“找不到模块”的错误。检查库的tsconfig.lib.json里的compilerOptions是否有"declaration": true，如果没有，开启后重新构建库。

按这个顺序走完流程，应该就能解决你的问题了！

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