WebStorm 不内置 iOS/Android 模拟器，仅封装 react-native run-ios 或 run-android 命令；能否运行取决于本地环境：iOS 需 Xcode + Command Line Tools（需在 Xcode Preferences → Locations 中指定），Android 需 Android Studio + SDK/AVD（须手动启动 AVD 并配置 ANDROID_HOME 和 PATH）；WebStorm 运行配置中 Working directory 必须设为 $ProjectFileDir$，Parameters 填 run-ios 或 run-android，Program 填 react-native（或其绝对路径）。
WebStorm 本身不管理模拟器，只调用 CLI 启动
WebStorm 没有内置 iOS 模拟器或 Android 模拟器，它只是封装了 react-native run-ios 或 react-native run-android 命令。能否跑起来，完全取决于你本地是否已装好对应平台的开发环境：Xcode + Command Line Tools（iOS），或 Android Studio + SDK/AVD（Android）。WebStorm 只负责“点一下就执行”，不解决底层环境缺失问题。
run-ios 配置失败常见原因和检查项
点击运行后卡在 info Found Xcode workspace "xxx.xcworkspace" 之后没反应，或报 xcodebuild: Command not found，大概率是以下几处没对：
-
Xcode已安装，但Command Line Tools未在 Xcode → Preferences → Locations 中选中（必须手动指定） -
which xcodebuild在终端返回空？说明系统 PATH 没包含/Applications/Xcode.app/Contents/Developer/usr/bin - 项目根目录下没有
ios/xxx.xcworkspace—— 检查是否执行过npx react-native init或pod install（iOS 项目首次需进ios/目录运行） - WebStorm 运行配置里
Parameters写成了run-ios --simulator="iPhone 15"，但实际设备名不匹配；建议先不加参数，让 CLI 自动选默认设备
run-android 启动不了模拟器？别指望 WebStorm 自动拉起 AVD
WebStorm 调用 react-native run-android 时，不会自动启动 Android 模拟器（AVD），也不会帮你创建它。它只检查 adb devices 是否有在线设备 —— 没有就直接报错 No connected devices!。
- 必须提前打开 Android Studio → Device Manager → 启动一个 AVD（或连真机）
- 确保
ANDROID_HOME环境变量指向 Android SDK 根目录（如/Users/xxx/Library/Android/sdk），且platform-tools在系统 PATH 中 - WebStorm 的运行配置中
Working directory必须设为项目根目录（不是android/子目录），否则 CLI 找不到android/app/build.gradle - 如果用的是较新 RN（0.73+），
run-android默认走新的newArchEnabled = true构建路径，某些旧 AVD 镜像可能不兼容，可临时在android/gradle.properties中加newArchEnabled=false
快捷运行配置怎么填才不踩坑
在 Run → Edit Configurations… 里新增 External Tool 时，这几个字段最容易填错：
-
Program：填react-native（不是完整路径），前提是它已全局可用；若报 command not found，改用which react-native输出的绝对路径，如/usr/local/bin/react-native -
Parameters：iOS 填run-ios，Android 填run-android；不要加引号，也不要写成npm run android -
Working directory：必须用宏$ProjectFileDir$（不是硬编码路径），否则跨机器迁移会失效 - 别漏掉前置 npm 配置：在同一个 Run Configuration 里，先加一个
npm类型的配置，Command设为help，再在它下面加 External Tool —— 否则 WebStorm 会跳过依赖检查直接执行
真正麻烦的从来不是 WebStorm 设置，而是 Xcode 或 Android SDK 的权限、签名、架构兼容这些底层细节。点「运行」前，先在终端里手动敲一遍 react-native run-ios 看是否成功，比反复调 WebStorm 配置更省时间。
