运行JavaScript程序时出现MODULE_NOT_FOUND错误，如何排查解决？

错误详情 #

node:internal/modules/cjs/loader:1145
  throw err;
  ^

Error: Cannot find module 'C:\Users\sande\3D Objects\JavaScript-Lesson\lesson08.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1142:15)
    at Module._load (node:internal/modules/cjs/loader:983:27)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:142:12)
    at node:internal/main/run_main_module:28:49 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

Node.js v21.7.2

错误原因 #

该错误核心是Node.js无法定位到指定路径下的目标文件，具体可能由以下情况导致：

• 目标文件lesson08.js不存在于路径C:\Users\sande\3D Objects\JavaScript-Lesson中
• 文件路径输入错误，包括拼写错误、大小写不一致（虽然Windows系统不严格区分，但仍可能引发问题）
• 路径包含特殊字符（如本例中的空格），未正确处理导致解析失败
• 文件被误删除、移动，或文件名被修改（比如隐藏了扩展名，实际是lesson08.js.txt）

解决办法 #

• 核对文件与路径：直接打开C:\Users\sande\3D Objects\JavaScript-Lesson目录，确认lesson08.js存在，检查文件名拼写和扩展名是否正确（需开启Windows显示文件扩展名选项）。
• 处理带空格的路径：运行命令时给路径添加双引号，示例：

  node "C:\Users\sande\3D Objects\JavaScript-Lesson\lesson08.js"
  

  或者先切换到文件所在目录再运行：

  cd "C:\Users\sande\3D Objects\JavaScript-Lesson"
  node lesson08.js
  

• 检查文件状态：确认文件未被删除、移动到其他目录，也没有被重命名。

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