使用Node.js运行JavaScript时如何修复“找不到模块{文件夹路径}”错误

以下是实用的排查和解决步骤：

• 检查路径拼写与格式
  确认导入模块的路径是否准确：

  • 相对路径必须以./或../开头，比如require('./routes')而非require('routes')（后者会去node_modules目录查找）
  • 注意大小写，Linux/macOS环境下路径大小写敏感，即便Windows不敏感，Node部分场景仍会严格校验

• 确认文件夹内的入口文件
  Node.js默认查找文件夹里的index.js（或.mjs/.cjs，取决于模块规范）作为入口：

  • 如果目标文件夹没有这类默认入口，导入时需指定具体文件名，比如require('./routes/api.js')
  • 也可在文件夹内新建package.json，通过"main"字段自定义入口，示例：

    {"main": "server.js"}
    

• 校验模块导入规范一致性
  禁止混用CommonJS和ES模块语法：

  • 使用require()时，确保文件为CommonJS规范（默认，或文件后缀.cjs）
  • 使用import/export时，需在项目根目录package.json添加"type": "module"，或文件后缀用.mjs

• 检查当前工作目录
  Node运行时的工作目录可能和预期的项目根目录不一致，可在代码中添加打印确认：

  console.log('当前工作目录:', process.cwd());
  

  若目录错误，要么切换到项目根目录再执行node .，要么用绝对路径启动脚本，比如node /Users/xxx/Projects/my-server/index.js

• 清除Node缓存（文件结构改动后）
  Node可能缓存模块解析结果，直接重启Node进程即可，或执行命令强制清除缓存：

  node --no-cache .
  

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