2026/4/6 7:23:25
网站建设
项目流程
网站做文献格式,淘宝客没网站怎么做,wordpress 主题小工具,有人免费资源吗Windows上从零搭建React Native开发环境#xff1a;一份实战派指南 你是不是也遇到过这种情况#xff1f;想用 React Native 写个 App#xff0c;结果刚打开文档#xff0c;就被一堆“安装 Node.js”“配置 JDK”“设置 ANDROID_HOME”搞得晕头转向。尤其是你在 Windows 上…Windows上从零搭建React Native开发环境一份实战派指南你是不是也遇到过这种情况想用 React Native 写个 App结果刚打开文档就被一堆“安装 Node.js”“配置 JDK”“设置 ANDROID_HOME”搞得晕头转向。尤其是你在 Windows 上开发网上教程五花八门有的说必须装 Android Studio 全家桶有的推荐用 Expo 躲开原生坑——到底该听谁的别急。这篇文章不讲空话不堆术语就带你从零开始在 Windows 系统上一步步搭出一个能跑起来、能调试、能真机测试的 React Native 开发环境。我会把每个环节的关键点、常见坑和解决方案都揉进去让你少走弯路。为什么是 Windows我们真的能好好开发吗先坦白React Native 最初确实是为 macOS 设计的毕竟 iOS 开发绕不开 Xcode。但如果你的目标是Android 应用那 Windows 完全够用而且越来越成熟。现在官方支持通过Windows Subsystem for Android (WSA)或 Intel HAXM 加速模拟器Gradle 构建流程也早已适配 Windows 路径规范。只要你避开几个典型陷阱完全可以实现高效开发。所以本文聚焦于✅ 使用标准 React Native CLI非 Expo✅ 支持真机调试 模拟器运行✅ 配合 VS Code 实现完整编码体验✅ 全程在 Windows 10/11 下完成准备好了吗咱们直接开干。第一步Node.js 和 npm —— 所有魔法的起点React Native 的核心其实是 JavaScript。而让 JS 在电脑上运行的就是Node.js。要装哪个版本别乱下最新版React Native 对 Node 版本很敏感。目前主流版本如 0.72推荐使用✅Node.js 18.x LTS长期支持版为什么不选 20 或 21因为很多依赖还没跟上容易出现unsupported engine报错。怎么安全安装去官网下载 https://nodejs.org 选择LTS 版本安装包.msi格式。安装时注意✅ 勾选 “Add to PATH”否则后面命令找不到❌ 不要自定义安装路径到带空格或中文的地方比如C:\Program Files\...就容易出问题安装完成后打开PowerShell 或 CMD不是 Git Bash部分脚本兼容性差输入node -v npm -v你应该看到类似输出v18.17.0 9.6.7如果有版本号说明成功了。 小技巧如果你想同时管理多个 Node 版本比如测试不同项目可以用 nvm-windows 。但它不是必需品新手建议先装固定版本。第二步JDK 11 —— Android 编译背后的“Java 引擎”虽然你写的是 JavaScript但最终打包成 APK 还得靠 Android 的构建系统 —— Gradle。而 Gradle 是用 Java 写的所以你需要JDKJava Development Kit。要不要装 Oracle JDK不用。现在社区普遍推荐开源免费的OpenJDK来自 Eclipse Adoptium 以前叫 AdoptOpenJDK。下载JDK 11注意不是 JREJRE 只能运行不能编译 https://adoptium.net/temurin/releases/?version11选择- Architecture: x64- Operating System: Windows- Package Type:.msi方便安装安装完后必须设置环境变量JAVA_HOME。怎么设置 JAVA_HOME按Win S搜索 “环境变量”点击 “编辑系统环境变量”点 “环境变量” 按钮在“用户变量”或“系统变量”中点击“新建”- 变量名JAVA_HOME- 变量值你的 JDK 安装路径例如C:\Program Files\Eclipse Adoptium\jdk-11.0.18.10-hotspot然后检查PATH是否包含%JAVA_HOME%\bin最后验证java -version javac -version如果都显示版本信息恭喜Java 已就位。第三步Android Studio SDK —— 原生世界的入口这一步最耗时间但也最关键。为什么非得装 Android Studio因为 React Native 的 Android 工程本质上是一个标准的 Android 项目。你要编译、打包、调试全都依赖 Android SDK 提供的工具链比如adb连接设备emulator启动模拟器aapt资源打包gradlew构建脚本执行器这些都在 Android Studio 安装过程中自动搞定。怎么装才不踩坑下载 Android Studio https://developer.android.com/studio安装时勾选以下组件- Android SDK- Android SDK Platform-Tools- Android SDK Build-Tools- Android Emulator- Performance (Intel ® HAXM)如果你 CPU 支持虚拟化加速⚠️ 重要提示建议将 SDK 安装路径改为无空格、无中文的目录比如C:\Android\Sdk设置 ANDROID_HOME 环境变量同样在“环境变量”里添加变量名值ANDROID_HOMEC:\Android\Sdk并在PATH中追加三项%ANDROID_HOME%\platform-tools %ANDROID_HOME%\tools %ANDROID_HOME%\emulator保存后重启终端。验证是否生效adb version emulator -list-avds前者应显示 ADB 版本后者列出已创建的虚拟设备目前为空也没关系。第四步创建你的第一个 React Native 项目终于到了激动人心的时刻创建项目打开 PowerShell进入你想存放项目的文件夹运行npx react-nativelatest init MyFirstApp这个命令会做几件事- 下载最新的 React Native 模板- 自动生成android/和ios/目录结构- 安装所有 JS 依赖react, react-native, metro 等等待几分钟直到看到 “Welcome to React Native!” 成功提示。启动 Metro 打包服务进入项目目录cd MyFirstApp npx react-native start浏览器会自动打开http://localhost:8081/debugger-ui这是可选的调试界面终端显示 Metro 正在监听文件变化。保持这个窗口开着——它是代码热更新的大脑。第五步运行在模拟器或真机上方法一用 Android 模拟器回到另一个终端窗口运行npx react-native run-android这时会发生一系列操作1. Metro 开始打包 JS bundle2. Gradle 开始构建 debug APK3. 如果没有正在运行的模拟器RN 脚本会尝试自动启动第一个 AVD但问题来了你还没有 AVD 啊创建一个 Android 虚拟设备AVD打开 Android Studio → Configure → AVD Manager → Create Virtual Device选择一台设备比如 Pixel 4→ 选择系统镜像推荐 API 30 的 x86_64 镜像→ Finish创建完成后你可以手动启动它emulator -avd Your_AVD_Name -netdelay none -netspeed full等模拟器完全启动后再运行npx react-native run-android就会自动安装并启动 App。 提示首次构建可能需要十几分钟Gradle 要下载各种依赖。后续构建会快很多。方法二连接真机调试更推荐插上手机打开 USB 调试模式开发者选项里开启。然后执行adb devices你会看到类似List of devices attached R58M9XXXXX device表示设备已识别。接着运行npx react-native run-androidApp 会自动安装到手机上并通过 Wi-Fi 或 USB 与 Metro 建立连接加载 JS bundle。 如果遇到白屏摇一摇手机调出开发者菜单 → Debug → Enable Live Reload / Hot Reloading常见问题 解决方案亲测有效❌ 报错Could not find an installed version of Gradle原因Gradle Wrapper 下载失败国内网络问题解决办法1. 进入android/gradle/wrapper/gradle-wrapper.properties2. 查看distributionUrl地址通常是https\://services.gradle.org/distributions/gradle-8.0-all.zip3. 手动用浏览器或代理下载这个 zip 包4. 放到本地缓存目录C:\Users\你的用户名\.gradle\wrapper\dists\gradle-8.0-all\随机文件夹5. 再次运行./gradlew它会跳过下载直接解压❌ 白屏 / Unable to load bundle原因Metro 服务器没连上或者防火墙阻止了 8081 端口解决方法1. 确保 Metro 正在运行2. 在开发者菜单中点击 “Dev Settings” → “Debug server host port for device”3. 输入你的电脑局域网 IP 端口例如192.168.31.100:80814. 返回主界面重新加载 JS 如何查本机 IP在 CMD 输入ipconfig找 IPv4 地址❌ Execution failed for task ‘:app:processDebugResources’经典资源编译错误。排查步骤1. 打开 Android Studio → SDK Manager2. 确认已安装当前项目所需的 Build Tools 版本查看android/build.gradle中的buildToolsVersion3. 清理缓存bash cd android ./gradlew clean cd .. npx react-native run-android推荐工具组合VS Code 插件加持别用记事本写代码推荐搭配Visual Studio Code必装插件ESLintPrettierReact Native Tools微软官方IntelliSense for CSS class names快捷键小贴士-Ctrl Shift P→ 输入 “React Native” 可快速启动命令- 修改代码后保存即自动刷新开启 Hot Reloading 后最后一点思考要不要用 Expo我知道你在想什么“Expo 不是更简单吗”确实Expo Go 可以让你免配置直接扫码预览适合快速原型验证。但它也有局限❌ 无法自由集成第三方原生模块如特定蓝牙库❌ 自定义启动画面、推送通知等受限❌ 到后期还是要 “eject” 回原生工程反而更麻烦所以我建议✅ 初学者可以试试 Expo 快速上手✅ 但要做真实项目早点熟悉原生环境才是正道结语环境只是开始真正的挑战在代码里看到 App 图标出现在手机屏幕上那一刻你会觉得前面所有的等待和折腾都值得。但这只是第一步。接下来你要面对的是状态管理、导航架构、性能优化、跨平台适配……那些才是真正考验功力的地方。不过没关系至少现在你的开发环境已经 ready 了。下一步我们可以聊聊- 如何用 React Navigation 实现页面跳转- 怎样接入 AsyncStorage 做本地存储- 有没有轻量级的状态管理方案如果你感兴趣欢迎留言告诉我你想了解的方向。我们一起把 React Native 玩明白。你现在准备好敲下第一行App.js了吗