VS Code中Git Bash执行node index.js遇MODULE_NOT_FOUND错误求助

问题场景 #

使用VS Code进行Web开发，已安装Git Bash与Node.js v21.6.1。在VS Code终端选择Bash环境，创建目录后在该目录内创建index.js文件，内容为：

console.log("hello");

执行node index.js命令时，未输出预期内容，出现以下错误：

prati@LAPTOP-A2ET79D1 MINGW64 ~/OneDrive/Desktop/WEB D/2.2+Native+Modules
$ node index.js
node:internal/modules/cjs/loader:1152
throw err;
^

Error: Cannot find module 'C:\Users\prati\OneDrive\Desktop\WEB D\2.2+Native+Modules\index.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1149:15)
    at Module._load (node:internal/modules/cjs/loader:990: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: []
}

解决步骤 #

• 验证文件与当前目录匹配

  1. 执行ls命令，确认当前目录下存在index.js，检查文件名拼写（比如是否误写为Index.js或index.jsx）。
  2. 执行pwd命令，确认终端当前工作目录就是index.js所在的目录，若不是则用cd命令切换到对应目录。

• 处理路径中的特殊字符
  当前目录路径包含空格（WEB D）和加号（2.2+Native+Modules），可能导致Node.js路径解析异常：

  1. 临时解决：给文件名或完整路径加引号执行：

     node "index.js"
     # 或使用完整路径
     node "/c/Users/prati/OneDrive/Desktop/WEB D/2.2+Native+Modules/index.js"
     

  2. 彻底解决：重命名目录，移除空格和特殊字符（比如改为WEB-D、2.2-Native-Modules），避免后续路径相关问题。

• 确认文件真实存在
  打开系统文件管理器，导航到目标目录，检查index.js是否确实存在，同时确认VS Code已保存该文件（可按Ctrl+S手动保存）。

内容的提问来源于stack exchange，提问作者Dr.Paradox