从npm安装的多文件模块无法找到自身本地文件如何解决

不用打包成单文件，按以下优先级排查修复即可：

• 补全相对导入的文件后缀
  CommonJS模式下Node默认只会匹配.js/.json/.node以及目录下的index.js，如果你的目标文件是.mjs/.cjs后缀，写require('./openapi')是找不到的，必须写全完整文件名。如果是TypeScript开发，检查tsconfig.json的moduleResolution配置，设为Node16/NodeNext时TS会自动给编译产物补全相对导入的后缀，避免漏后缀报错。ESM模式下所有相对导入必须写全文件后缀，没有默认匹配规则。
• 校验发布包的文件清单
  很多人配置package.json的files字段时只写了入口文件，比如"files": ["dist/index.js"]，npm发布时只会把清单内的文件打包进去，你本地node_modules里看到的其他文件大概率是之前本地调试npm link或者缓存留下的，不是实际发布的内容。直接把整个dist目录加入发布清单："files": ["dist/**/*"]，发布前执行npm pack --dry-run，查看终端输出的打包文件列表，确认所有依赖的多文件都在列表内再发版。
• 修正exports字段的路径映射
  如果你的包配置了exports字段，Node会严格按照exports的映射规则解析路径，不会自动扫描目录下的文件。如果只配置了主入口"exports": "./dist/index.js"，入口文件里的相对子路径导入会被拦截，直接报模块不存在。要么给所有对外暴露的子路径补全映射，要么用通配符放开整个dist目录的访问：

  {
    "exports": {
      ".": "./dist/index.js",
      "./*": "./dist/*.js"
    }
  }
  

  如果同时兼容CJS和ESM，记得分别给require和import场景配置对应入口文件，别写错路径。
• 排查文件名大小写问题
  macOS、Windows默认是大小写不敏感的文件系统，本地开发时写./openapi能找到实际命名为OpenAPI.js的文件，但npm包安装在Linux环境（服务器、CI环境）时，文件系统大小写敏感，会直接报找不到模块。本地可以执行git config core.ignorecase false开启git大小写校验，避免文件名大小写不一致的问题提交到仓库。
• 对齐模块类型和导入语法
  如果package.json里配置了"type": "module"，整个包会被当作ESM模块解析，这时候用CommonJS的require()语法导入本身就会触发解析异常，要么统一改成ESM的import语法（记得写全后缀），要么把CommonJS格式的文件后缀改成.cjs做显式标记。

排查时可以直接在项目根目录执行node -e "console.log(require('你的包名'))"触发报错，顺着报错栈打开node_modules里对应包的实际文件，对照磁盘上的文件路径逐字符核对，比单纯看报错信息效率高很多。

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