Node运行项目时报MODULE_NOT_FOUND错误，求解决方案

最近在个人电脑上用Node创建项目时，安装依赖后运行总会出现相同错误，具体情况如下：

Vite项目报错示例 #

执行npm run dev时出现以下错误：

"[path of my proyect]\node_modules\.bin\" not recognized as an internal or external command,
program or executable batch file.
node:internal/modules/cjs/loader:1080
  throw err;
  ^

Error: Cannot find module 'C:\Users\Usuario\vite\bin\vite.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1077:15)
    at Module._load (node:internal/modules/cjs/loader:922:27)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
    at node:internal/main/run_main_module:23:47 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

Electron项目报错示例 #

在含空格的文件夹目录下创建Electron项目，执行electron .命令时出现类似错误：

"[in this case it seems not to be the full path of my project since it seems to be cut since the name of the folder that contains it has a space]" not recognized as an internal or external command,
program or executable batch file.
node:internal/modules/cjs/loader:1080
  throw err;
  ^

Error: Cannot find module 'C:\Users\Usuario\electron\cli.js'
    at Module._resolveFilename (node:internal/modules/cjs/loader:1077:15)
    at Module._load (node:internal/modules/cjs/loader:922:27)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
    at node:internal/main/run_main_module:23:47 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

已尝试的解决操作 #

• 卸载并重新安装Node
• 删除项目目录下的node_modules文件夹和package-lock.json文件后重新执行npm i

以上操作均未解决问题，求可行的解决方法。

1. 解决路径空格问题 #

从Electron报错能看出，项目所在文件夹含空格导致路径被截断，这是Windows系统下的典型问题：

• 立即将项目迁移到**无空格、无特殊字符（中文、符号等）**的目录，比如C:\Projects\MyViteApp，而非C:\Users\Usuario\My Vite App。
• 迁移后删除原node_modules和package-lock.json，重新执行npm i。

2. 修复npm bin目录配置 #

错误提示node_modules\.bin无法识别，大概率是npm配置或环境变量异常：

• 以管理员身份打开终端，执行命令重置npm前缀配置：

  npm config set prefix "C:\Users\Usuario\AppData\Roaming\npm"
  

  （路径替换为你实际的npm全局安装目录，一般在用户目录下的AppData\Roaming\npm）
• 检查系统环境变量PATH，确认包含C:\Users\Usuario\AppData\Roaming\npm和C:\Program Files\nodejs，缺失则手动添加。

3. 用npx替代直接执行命令 #

npx会自动定位项目内node_modules\.bin下的可执行文件，规避路径识别问题：

• Vite项目执行：

  npx vite dev
  

• Electron项目执行：

  npx electron .
  

4. 清理npm缓存并重装依赖 #

缓存损坏可能导致依赖安装不完整：

• 执行命令强制清理缓存：

  npm cache clean --force
  

• 删除项目的node_modules、package-lock.json、yarn.lock（如有），重新安装：

  npm install
  

5. 检查Node版本兼容性 #

确保Node版本与Vite、Electron的要求匹配：

• Vite要求Node 14.18+或16+，Electron对Node版本也有对应限制，可查看官方文档的兼容表。
• 用nvm（Node版本管理器）切换到符合要求的版本，避免版本不兼容引发的路径问题。

内容的提问来源于stack exchange，提问作者miguel francisco ruales pianda