npm包eulejs导入失败：ERR_MODULE_NOT_FOUND问题求助

错误日志： #

[nodemon] starting `node ./src/index.js`
node:internal/errors:484
    ErrorCaptureStackTrace(err);
    ^

Error [ERR_MODULE_NOT_FOUND]: Cannot find package '/home/brunolnetto/github/alloyha/experiments/web/eulejs-MVP/node_modules/eulejs/' imported from /home/brunolnetto/github/alloyha/experiments/web/eulejs-MVP/src/index.js
    at new NodeError (node:internal/errors:393:5)
    at legacyMainResolve (node:internal/modules/esm/resolve:235:9)
    at packageResolve (node:internal/modules/esm/resolve:847:14)
    at moduleResolve (node:internal/modules/esm/resolve:909:20)
    at defaultResolve (node:internal/modules/esm/resolve:1124:11)
    at nextResolve (node:internal/modules/esm/loader:163:28)
    at ESMLoader.resolve (node:internal/modules/esm/loader:841:30)
    at ESMLoader.getModuleJob (node:internal/modules/esm/loader:424:18)
    at ModuleWrap.<anonymous> (node:internal/modules/esm/module_job:76:40)
    at link (node:internal/modules/esm/module_job:75:36) {
  code: 'ERR_MODULE_NOT_FOUND'
}

Node.js v18.12.1
[nodemon] app crashed - waiting for file changes before starting...

排查与解决建议： #

• 检查eulejs包的package.json核心配置

  • 确认main字段指向正确的入口文件路径，若包为ES模块，需同时设置type: "module"；若为CommonJS模块，确保入口文件为.js或.cjs格式，无需设置type: "module"。
  • 确认files字段包含核心代码目录（如src/或dist/），若未设置files，需确保核心文件未被.gitignore或.npmignore排除，否则发布后npm不会包含这些文件。

• 验证测试项目的导入逻辑

  • 若eulejs是ES模块，测试项目的package.json需设置type: "module"，导入语句使用import eulejs from 'eulejs'；若为CommonJS模块，导入语句使用const eulejs = require('eulejs')，避免模块类型不匹配。

• 检查安装后的文件完整性

  • 进入测试项目的node_modules/eulejs目录，查看package.json中main字段指定的文件是否存在。若不存在，说明包发布时遗漏核心文件，调整包配置后重新发布。
  • 尝试清理重装：删除测试项目的node_modules和package-lock.json，执行npm install，确保安装过程无报错。

• 本地npm link问题修复

  • 在本地eulejs包目录执行npm link，再到测试项目执行npm link eulejs，检查node_modules/eulejs是否为指向本地包的正确软链接。
  • 本地包的package.json需保持正确的main和type配置，否则link后Node无法识别入口文件。

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