如何在Visual Studio Android模拟器中运行React Native应用

云原生阿岚

2026-5-25

解决Visual Studio Android模拟器运行React Native应用的构建错误

嘿，作为过来人，我碰到过和你一模一样的问题，给你几个实用的排查方向，应该能帮你解决这个构建报错：

先确认adb是否能识别到你的VS模拟器
打开命令提示符或者终端，输入adb devices，看看列表里有没有你的Visual Studio Android模拟器。如果没显示，说明adb和模拟器的连接出了问题——你需要确保React Native使用的adb和VS模拟器的adb是同一个版本。可以把VS模拟器目录下的adb路径（一般在C:\Program Files (x86)\Microsoft Emulator Manager\adb）添加到系统环境变量的PATH里，或者手动指定React Native用这个adb。
检查Android SDK路径配置
打开你的React Native项目，看看android文件夹下有没有local.properties文件。如果没有，手动创建一个，里面写入你的Android SDK路径，比如：
```
sdk.dir=C:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk
```
（注意Windows系统路径要用双反斜杠转义）如果已经有这个文件，确认路径是否正确，别写错了。
清理构建缓存再重新尝试
缓存冲突是构建失败的常见原因，试试这套命令：
```
cd android
./gradlew clean
cd ..
react-native run-android
```
先进入android目录执行清理，再回到项目根目录重新运行构建命令。
检查模拟器的网络连接
VS模拟器偶尔会出现网络异常，导致gradle无法下载构建依赖。你可以打开模拟器的设置，把网络模式切换为桥接模式，确保模拟器能正常访问外网，这样gradle才能顺利拉取需要的资源。
确认Gradle版本兼容性
打开android/build.gradle文件，检查gradle的版本和com.android.tools.build:gradle插件版本是否匹配。比如Gradle 7.x对应的插件版本也得是7.x系列，版本不匹配会直接导致构建失败。你可以参考React Native官方文档里的推荐版本来调整。