执行npm create vite@latest初始化Vite时遇模块找不到错误求助

开发者阿泽

2026-7-7

问题描述

在Gitbash中执行npm create vite@latest初始化Vite项目时，出现如下错误：

$ npm create vite@latest
'Company\AppData\Local\npm-cache\_npx\1415fee72ff6294b\node_modules\.bin\' is not recognized as an internal or external command,
operable program or batch file.
node:internal/modules/cjs/loader:1080
  throw err;
  ^

Error: Cannot find module 'C:\Users\create-vite\index.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:86:12)
    at node:internal/main/run_main_module:23:47 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

Node.js v18.18.2
npm ERR! code 1
npm ERR! path C:\Users\Media4th&amp;Company\desktop\vite
npm ERR! command failed
npm ERR! command C:\Windows\system32\cmd.exe /d /s /c create-vite

npm ERR! A complete log of this run can be found in: C:\Users\Media4th&amp;Company\AppData\Local\npm-cache\_logs\2023-10-30T00_59_40_173Z-debug-0.log

解决方案

清理npm缓存
执行以下命令清除可能损坏的缓存，避免路径解析错误：
```
npm cache clean --force
```
之后重新尝试npm create vite@latest。
全局安装create-vite后调用
绕过npx的路径解析问题，先全局安装create-vite：
```
npm install -g create-vite
```
然后直接执行create-vite来初始化项目。
更换到无特殊字符的目录操作
当前用户目录包含&和空格这类特殊字符，会导致npx解析路径时出错。建议把项目创建到路径干净的文件夹（比如C:\Projects\vite-demo），再执行初始化命令。
换用CMD或PowerShell执行命令
部分情况下Git Bash对Windows路径的转义处理会出问题，尝试在CMD或者PowerShell中执行npm create vite@latest，看是否能正常运行。