使用npm link关联notistack库后启动项目报错，应如何排查解决？

构建报错解决 #

• 先清理notistack本地仓库的冗余文件，Win10 Powershell执行：Remove-Item -Recurse -Force node_modules, package-lock.json，再执行npm install重装依赖，排除依赖版本不匹配问题
• 执行npm cache clean --force清理npm全局缓存，避免缓存的损坏文件导致构建失败
• 构建前关闭所有占用notistack目录的进程，包括IDE的实时索引、文件资源管理器窗口、其他打开的终端，Win10文件占用是本地库构建偶发失败的最常见原因

npm link 操作修正 #

• 必须保证notistack执行npm run build完全成功后，再在notistack目录下执行npm link，否则目标项目关联的是缺失构建产物的目录，启动必然报错
• 目标项目执行npm link notistack前，可以先执行npm unlink notistack -g && npm unlink notistack清除旧的软链接，避免旧的错误关联影响
• 可以在notistack的package.json的scripts中添加一键关联命令，减少操作失误：

  "scripts": {
    "build:link": "npm run build && npm link"
  }
  

  后续需要更新关联时直接执行npm run build:link即可

Win10 系统配置优化 #

• 打开Win10设置-更新和安全-开发者选项，开启开发者模式，解除软链接的默认权限限制
• 把notistack的dist目录加入IDE（如VSCode）的排除索引列表，避免IDE实时扫描占用构建产物文件
• 所有npm操作都用普通权限终端执行，不要用管理员权限，避免生成的软链接权限和项目运行权限不匹配

替代方案 #

如果上述操作还是无法解决偶发问题，可以直接用本地路径安装的方式替代npm link，在目标项目执行npm install 你的notistack本地目录绝对路径，稳定性更高，不会出现软链接相关的兼容问题

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