Angular项目使用NPM link时应用无法找到链接库依赖怎么办

npm link 本质是创建全局软链接映射，默认不会把被链接的本地依赖库自身的 node_modules 加入主应用的依赖解析路径。主应用查找依赖时只会遍历自身目录下的 node_modules、软链接目标的上级目录，找不到被链接库声明的子依赖时就会抛出缺失错误。而从npm源安装正式发布的包时，npm会自动把包的依赖平铺安装到主应用的 node_modules 目录，所以不会出现同类问题。

• 第一步先确认本地依赖库的依赖安装完整：进入本地依赖库的根目录，执行npm install，确保所有package.json里声明的依赖都已经装到本地依赖库自己的node_modules里。这是最容易遗漏的步骤——本地调试依赖库时经常只安装了部分开发依赖，link前没全量安装就会直接报依赖缺失。
• 如果安装完依赖还是报错，在主应用目录下手动链接缺失的子依赖：比如报错提示缺少xxx包，就在主应用目录执行npm link xxx，把全局链接的对应包映射到主应用的依赖解析路径里。
• 如果你使用的是npm 7及以上版本，link时增加--install-links参数，让npm自动处理被链接包的依赖安装，不需要手动逐个链接缺失包：

  # 先进入本地依赖库根目录执行全局注册
  npm link
  # 回到主应用目录执行链接，带参数自动安装依赖
  npm link <你的本地依赖库包名> --install-links
  

• 不想折腾软链接的依赖解析逻辑，可以用和正式发布包行为完全一致的本地安装方案：在本地依赖库根目录执行npm pack，生成后缀为.tgz的本地包压缩文件，再回到主应用目录直接安装这个压缩包，不会出现依赖解析异常：

  # 本地依赖库根目录执行，生成对应版本的tgz包
  npm pack
  # 主应用目录执行，替换为你本地生成的tgz文件的实际路径
  npm install /本地路径/你的依赖库名-版本号.tgz
  

注意：如果你的本地依赖库声明了peerDependencies，需要确保主应用侧已经安装了符合版本要求的对应依赖。peerDependencies本身不会被npm自动安装，无论使用link还是安装正式发布包，都需要主应用手动安装匹配版本的peer依赖。

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