You need to enable JavaScript to run this app. 为什么执行npx create-react-app创建React应用时会一直卡住?
优惠活动
大模型
产品
解决方案
定价
更多

为什么执行npx create-react-app创建React应用时会一直卡住?

create-react-app 安装流程假死无响应处理方案

先修复初始弹出的npm更新检查报错

  • 终端里提示的sudo chown类命令是npm跨平台输出的冗余内容,Windows环境不需要执行Linux权限命令,直接对C:\Users\alanp\.config目录做权限修复即可:
    • 关闭所有正在运行的node、npm相关进程
    • 以管理员身份打开PowerShell,执行命令为当前用户授予该目录的完全控制权限:
      icacls "C:\Users\alanp\.config" /grant "${env:UserName}:(OI)(CI)F" /T
      
    • 执行完成后重启普通终端,确认npm的更新报错提示不再弹出。

解决依赖安装环节永久卡住的核心问题

注意 目前的项目路径嵌套在OneDrive同步目录下(路径为C:\Users\alanp\OneDrive\Desktop\...),OneDrive的实时文件扫描会锁定npm正在写入的依赖文件,直接导致安装流程假死。创建项目时先把项目生成在非同步的纯本地路径(如C:\dev\my-app),等全量文件安装完成、验证可正常启动后,再将项目文件夹移动到目标存放位置。

  • 优化npm拉取链路,解决无超时提示的网络挂起

    • 切换npm镜像源为可稳定访问的公共源,避免官方源连接超时无反馈:
      npm config set registry https://registry.npmmirror.com
      
    • 清理损坏的本地npm缓存,避免缓存校验环节假死:
      npm cache clean --force
      
  • 绕开create-react-app的自动安装流程

    • 不要使用全局安装的旧版create-react-app,直接通过npx引导最新版本创建项目,强制指定npm作为包管理器:
      npx create-react-app my-app --use-npm
      
    • 如果仍卡在安装环节,可手动完成剩余依赖安装流程:
      1. 确认已自动生成的my-app目录下的package.json已写入react、react-dom、react-scripts的对应版本配置
      2. 通过终端进入该my-app目录,手动执行依赖安装命令:
        npm install --no-audit --no-fund
        
      3. 安装完成后执行npm start验证项目可正常启动。
  • 补充排查项

    • 关闭代理软件的全局规则,避免node进程的HTTPS请求被代理拦截后无反馈
    • 确认杀毒软件未对node、npm的可执行程序加实时拦截规则,防止依赖文件被扫描进程锁定无法写入

内容的提问来源于stack exchange,提问作者Veilios

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 19:54:02