Angular库通过npm link引入时报Module not found错误的问题求解

• 引入路径存在低级拼写错误：你代码中写的引入路径是../../../workspace-test/dest/lib-test，但Angular库构建产物默认输出在dist目录，不是dest。
• 引入方式不符合npm link的使用逻辑：你已经通过npm link关联了本地库，完全不需要写绝对/相对路径引入，相对路径会导致模块解析逻辑混乱，触发路径匹配失败。
• Angular CLI默认关闭软链接解析支持：没有配置preserveSymlinks的情况下，npm link创建的软链接会被Angular构建工具忽略，导致模块找不到。
• 部分场景下存在库导出配置错误的可能：比如库的public-api.ts未导出对应模块，或者构建后package.json的main/module字段指向路径错误。

1. 修正引入代码，删除相对路径直接按库名引入：

import { LibTestModule } from 'lib-test';

// 模块imports部分保持不变
imports: [
  LibTestModule,
]

2. 打开应用根目录的angular.json，找到对应项目的build配置项，添加preserveSymlinks: true：

{
  "projects": {
    "app-test": {
      "architect": {
        "build": {
          "options": {
            // 原有配置保留，新增下面这行
            "preserveSymlinks": true
          }
        }
      }
    }
  }
}

3. 检查库项目配置正确性：

• 确认库根目录的public-api.ts已经导出了LibTestModule
• 确认构建后的dist/lib-test目录下的package.json中module字段指向路径正确，通常为./fesm2022/lib-test.mjs这类格式

4. 重启应用开发服务，修改配置后必须重启ng serve才能生效。

如果修改后仍报错，执行以下操作重置软链接和缓存：

• 分别在库的dist目录和应用目录执行npm unlink lib-test
• 重新构建库后，在dist目录重新执行npm link
• 应用目录重新执行npm link lib-test
• 应用目录删除node_modules缓存后重启服务

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