在WebStorm中运行React Native应用的模拟器配置-webstorm-PHP中文网

webstorm 不启动模拟器，仅调用 cli 命令；ios 需 xcode 及 command line tools，android 需 android studio、sdk 和已启动 avd；调试前必须手动启用 debug js remotely。

在webstorm中运行react native应用的模拟器配置

WebStorm 没有内置 iOS 或 Android 模拟器。它只是封装 react-native run-ios 或 react-native run-android 命令，执行效果完全取决于你本地是否装好对应平台的开发环境。

常见误判：点了运行按钮没反应，就以为是 WebStorm 配置错了——其实大概率是 Xcode、Android Studio 或环境变量根本没配好。

iOS 依赖：Xcode + Command Line Tools（必须在 Xcode → Preferences → Locations 中手动指定）
Android 依赖：Android Studio + SDK + 已创建并启动的 AVD（WebStorm 不会自动拉起模拟器）
ANDROID_HOME 必须指向 SDK 根目录（如 /Users/xxx/Library/Android/sdk），且 platform-tools 在系统 PATH 中

典型现象：终端或 WebStorm 运行日志停在 info Found Xcode workspace "MyApp.xcworkspace"，之后无响应，也不报错。

本文档主要讲述的是React Native For Android 源码编译；希望对大家会有帮助；感兴趣的朋友可以过来看看

下载

运行 which xcodebuild，返回空？说明系统找不到 xcodebuild —— 检查 PATH 是否包含 /Applications/Xcode.app/Contents/Developer/usr/bin
项目根目录下没有 ios/MyApp.xcworkspace？首次初始化后需进 ios/ 目录手动执行 pod install（尤其 RN ≥ 0.60）
WebStorm 运行配置中 Parameters 写了 run-ios --simulator="iPhone 15"，但设备名不匹配（可用 xcrun simctl list devices 查真实名称）；建议先删掉参数让 CLI 自动选

WebStorm 调用 react-native run-android 时，只做一件事：执行 adb devices，发现无在线设备就直接失败。它不会帮你开 AVD，也不会提示“请先启动模拟器”。

必须提前在 Android Studio → Device Manager 中启动一个 AVD（或连真机）
确认 adb devices 在终端能列出设备（状态为 device，不是 offline 或 unauthorized）
WebStorm 运行配置的 Working directory 必须设为项目根目录（即含 android/ 子目录的位置），不能设成 android/ 本身
RN ≥ 0.73 默认启用新架构（newArchEnabled = true），部分旧 AVD 镜像可能不兼容；可临时在 android/gradle.properties 中加 newArchEnabled=false 测试

WebStorm 启动 App 后，JS 断点不会自动生效。Metro 默认走本地 bundle，必须手动切换到远程调试模式，否则断点灰色、跳转不到源码、或直接报 SyntaxError: Unexpected token import。

Android 模拟器：按 Ctrl+M（Windows/Linux）或 Cmd+M（macOS）唤出菜单 → 点 Debug JS Remotely
Android 真机：摇晃手机（幅度要大），或执行 adb shell input keyevent 82
确保 Chrome 已安装 JetBrains IDE Support 插件（作者 JetBrains s.r.o.），且 chrome://inspect/#devices 显示 IDE connected
WebStorm 运行配置里务必取消勾选 Start React Native Bundler，避免和已运行的 npx react-native start 冲突

最容易被忽略的是：模拟器或真机上没手动点 Debug JS Remotely，就以为断点该生效了——它真的不会自己连上。