You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows10下React Native初始化失败求助:react-native init无法运行

React Native 环境搭建失败解决方案(含特殊字符用户名问题)

问题根源

你的判断完全正确,问题出在用户名中的&符号和空格:

  • Windows PowerShell中,&是命令分隔符,会将用户路径拆分成多个片段,导致npm解析路径时出现截断,误以为模块路径是C:\Users@react-native-community\cli\build\bin.js
  • 空格也会让命令行工具误判路径边界,引发ENOENT路径找不到的错误

可行解决方案

方案1:临时绕开用户目录,在纯净路径初始化项目

直接在无空格、无特殊字符的目录下创建项目,快速解决当前问题:

  1. 打开PowerShell,执行以下命令创建并进入目标目录:
    mkdir C:\RN-Projects
    cd C:\RN-Projects
    
  2. 重新执行项目初始化命令:
    npx react-native@latest init AwesomeProject
    

方案2:修改npm全局路径,彻底解决特殊字符问题

配置npm使用无特殊字符的全局安装目录,避免后续所有全局包操作出错:

  1. 创建两个新目录:C:\npm-global(全局包安装路径)和C:\npm-cache(缓存路径)
  2. 在PowerShell中执行命令修改npm配置:
    npm config set prefix "C:\npm-global"
    npm config set cache "C:\npm-cache"
    
  3. 打开系统环境变量设置:
    • 添加C:\npm-global到系统Path变量中
    • 移除之前用户目录下的npm相关路径
  4. 重启PowerShell和VS Code,再执行项目初始化命令

方案3:确认Android SDK路径无特殊字符(可选)

确保Android SDK路径完全纯净,避免后续编译阶段出现异常:

  1. 打开Android Studio,进入Settings > Appearance & Behavior > System Settings > Android SDK
  2. 点击Edit按钮,选择C:\Android\Sdk作为新路径,等待SDK迁移完成
  3. 更新系统环境变量ANDROID_HOME为C:\Android\Sdk,并同步更新Path中的%ANDROID_HOME%\platform-tools路径

验证环境

执行完方案后,在PowerShell中运行以下命令验证环境是否正常:

node --version
npm --version
npx react-native --version

所有命令正常返回版本号后,即可正常初始化和运行React Native项目。

内容的提问来源于stack exchange,提问作者Tancrède Corpet

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.15 16:53:12