Win11装Node后create-react-app创建项目安装中止如何解决
Windows 11 下 create-react-app 初始化失败可行解决方案
操作前先把所有打开的终端、代码编辑器全关了,避免文件占用导致操作不生效。
- 清理旧版本残留与损坏缓存
之前全局装过旧版create-react-app导致版本冲突、npx缓存损坏是最高发的故障原因,依次跑以下命令彻底清理:npm uninstall -g create-react-appyarn global remove create-react-appnpx clear-npx-cache
要是清缓存命令跑报错,直接手动删对应目录就行:- 打开资源管理器,进
C:\Users\<你的当前用户名>\AppData\Roaming\npm-cache,把所有名字带create-react-app的文件夹全删了 - 进
C:\Users\<你的当前用户名>\.npm\_npx,把这个目录下的东西全清空
- 打开资源管理器,进
- 修复PowerShell执行权限
Win11默认的PowerShell执行策略会拦Node相关脚本运行,右键点PowerShell选「以管理员身份运行」,跑下面的命令:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
弹确认提示的时候输Y敲回车就行,这个配置只允许本地可信脚本跑,不会有安全问题。 - 检查Node版本与源配置
- 跑
node -v看Node版本,create-react-app只兼容14.x、16.x、18.x的LTS长期支持版,20.x以上的尝鲜测试版有一堆依赖兼容问题,版本不对就先卸了当前Node,装18.x LTS版本,装完重启终端再操作 - 国内连npm官方源经常丢包导致依赖下不全,跑下面的命令切国内镜像源:
npm config set registry https://registry.npmmirror.com
跑完跑npm config get registry,返回的是镜像源地址就说明配成了
- 跑
- 规避路径兼容问题
初始化项目的路径必须全是英文,不能有空格、中文、特殊符号,别把项目放C:\Users\张三\桌面\我的项目这种中文路径下,也别放C:\Program Files、C:\Windows这种受系统权限管控的目录,直接在盘根目录建个纯英文的代码文件夹就行,比如D:\code\react-demo。 - 兜底方案
上面的步骤全试了还是不行,就别死磕旧版create-react-app了,用官方现在推荐的新方式初始化:- React官方新的初始化命令:
npm init react-app <你的项目名> - 现在行业更常用的Vite方案,比create-react-app启动快好几倍,也没那么多依赖破事:
npm create vite@latest <你的项目名> -- --template react,跑完进项目目录执行npm install、npm run dev就能正常起开发服务。
- React官方新的初始化命令:
提醒:跑安装命令的时候把360、腾讯电脑管家这类安全软件退了,经常乱拦截文件写入导致安装中途失败。
内容的提问来源于stack exchange,提问作者Murugan Arumugam
相关产品推荐
相关产品推荐

