将本地deploy-abc文件夹作为npm模块安装后无法访问的问题

这种本地模块安装后找不到的情况我碰到过好多次，大概率是以下几个配置环节出了问题，咱们一步步排查解决：

• 检查deploy-abc目录下的package.json配置
  Node解析本地模块时，会优先读取模块根目录下package.json的main字段来确定入口文件。如果你的入口是src/index.js，但package.json里没设置main字段，或者设置的路径不对（比如只写了index.js而不是./src/index.js），Node就找不到正确的入口。
  另外，如果你的项目用了ES模块（比如设置了"type": "module"），还要确保入口文件的后缀是.mjs或者在package.json里声明了type，避免CommonJS和ES模块的解析冲突。

• 确认deploy-abc存在合法的package.json
  如果deploy-abc文件夹里没有package.json，哪怕yarn能成功安装这个本地依赖，Node也无法正确识别它作为一个合法的Node模块。你可以在deploy-abc目录下运行yarn init -y快速生成一个基础的package.json，然后根据需要修改name、main等字段。

• 检查依赖名称与导入语句是否匹配
  你安装时用的是本地路径，但main-folder的package.json里这个依赖的名称是deploy-abc吗？或者要看deploy-abc自己的package.json里的name字段是什么——导入模块时必须用这个name字段的值，而不是文件夹名。比如如果deploy-abc的package.json里name是my-deploy-service，那你导入时就得写import xxx from 'my-deploy-service'，而不是deploy-abc。

• 尝试用yarn link替代直接路径安装（开发阶段更可靠）
  直接用路径安装有时候会出现缓存或者链接异常的问题，换成yarn link的方式可能更稳定：

  1. 进入deploy-abc目录，运行：yarn link
  2. 回到main-folder目录，运行：yarn link deploy-abc（这里的名称要和deploy-abc的package.json里的name一致）
     这种方式会在全局建立软链接，更适合本地开发时调试模块。

• 清理缓存并重新安装
  有时候yarn的缓存会导致异常，你可以尝试清理后重新安装：

  1. 先卸载依赖：yarn remove deploy-abc
  2. 清理yarn缓存：yarn cache clean
  3. 重新安装本地依赖：yarn add "/var/www/main-folder/deploy-abc"

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