Windows11下React Native全局环境搭建报错：编译组件检查失败

分步排查方案 #

• 检查Visual Studio 2019组件完整性
  打开Visual Studio Installer选择「修改」，确认勾选以下核心组件：

  • 通用Windows平台开发（需包含Windows 10 SDK 10.0.19041.0及以上版本）
  • 桌面开发使用C++（必须包含MSVC v142构建工具、Windows SDK基础组件）
    卸载Build Tools后，务必确认VS Community自带的构建工具未被误删。

• 验证环境变量配置有效性
  除已添加的VS安装路径，需确保以下路径加入系统Path环境变量：

  • C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin
  • C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\<你的MSVC版本号>\bin\Hostx64\x64（替换<你的MSVC版本号>为实际安装版本，如14.29.30133）
  • C:\Windows\Microsoft.NET\Framework64\v4.0.30319
    配置后重启终端，执行msbuild -version和cl命令，能正常输出版本则说明路径生效。

• 手动定位脚本检查失败点

  1. 下载脚本到本地：Invoke-WebRequest -Uri https://aka.ms/rnw-vs2019-deps.ps1 -OutFile rnw-deps.ps1
  2. 打开脚本找到Check-VS相关函数，逐行执行检查命令：
     • 验证VS路径：Test-Path "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community"
     • 验证MSBuild：Get-Command msbuild -ErrorAction SilentlyContinue
     • 验证Windows SDK：Get-ChildItem "C:\Program Files (x86)\Windows Kits\10\Include\" | Sort-Object Name -Descending | Select-Object -First 1
       哪个命令返回失败，对应组件即为问题所在。

• 关联Promise拒绝问题的环境校验

  • 执行node -v和npm -v确认Node.js版本为16.x/18.x LTS（React Native推荐版本）
  • 清理npm缓存并重装全局CLI：npm cache clean --force && npm install -g react-native-cli
  • 若已安装react-native doctor，执行该命令自动检测依赖缺失并获取修复建议。

• 终端权限与执行策略确认
  确保以管理员身份启动PowerShell，执行Get-ExecutionPolicy -Scope Process确认当前策略为Unrestricted；若脚本仍报错，手动逐行执行脚本内的步骤，定位具体失败环节。

内容的提问来源于stack exchange，提问作者Lauro235