PyCharm 2025.3 Help

React Native

使用 React Native ,您可以使用 JavaScript 和 React 为 iOS 和 Android 开发原生移动应用。 它由 Facebook 创建,被 Instagram、Airbnb 等知名应用采用,现在 JetBrains 自家的 YouTrack 移动版 应用也在使用。 请参阅 React Native 官方网站了解更多信息。

PyCharm 可帮助您创建、编辑、执行 lint、运行、调试并维护 React Native 应用。 PyCharm 还为 React 和 Flow 符号提供代码补全。

开始之前

  1. 请确保您的计算机上已安装 Node.js

  2. 请确保在 设置 | 插件 页面、 已安装 选项卡上启用了所需插件 JavaScript 和 TypeScriptJavaScript 调试器。 有关更多信息,请参阅 管理插件

创建新的 React Native 应用

  1. 在主菜单中点击 文件 | 新建 | 项目。 或者,在欢迎界面的左侧窗格中点击 新建 | 新建项目

    将打开 新建 项目 对话框

  2. 在左侧窗格中选择 React Native

  3. 在右侧窗格:

    1. 指定用于存储项目相关文件的文件夹路径。

    2. Node 运行时 字段中指定要使用的 Node.js 运行时。 从列表中选择已配置的运行时,或选择 添加 以配置新的运行时。

    3. React Native 列表中,选择 npx --package react-native-cli react-native

      或者,对于 npm 5.1 及更早版本,请在 终端 Alt+F12 中运行 npm install -g react-native-cli ,自行安装 react-native-cli 包。 创建应用时,选择存放 react-native-cli 包的文件夹。

  4. 点击 创建 后,PyCharm 将生成一个特定于 React Native 的项目,包含所有必需的配置文件,下载依赖项,并基于默认设置创建一个类型为 React Native 的运行/调试配置。

从现有 React Native 应用开始

要继续开发现有的 React Native 应用,请在 PyCharm 中将其打开并下载所需依赖项。

打开您计算机上已有的应用源代码

  • 欢迎 屏幕的左侧窗格中点击 打开 ,或者从主菜单中选择 文件 | 打开。 在打开的对话框中,选择存放源代码的文件夹。

从您的版本控制系统中检出应用源代码

  1. 欢迎 屏幕的左侧窗格中点击 克隆

    或者,从主菜单中选择 文件 | 新建 | 来自版本控制的项目…Git | 克隆…VCS | 从版本控制获取

    在主菜单中,可能不会显示 Git ,而是显示与您的项目关联的其他版本控制系统。 例如, MercurialPerforce

  2. 在打开的对话框中,从列表中选择您的版本控制系统,并指定要从中检出应用源代码的存储库。 有关更多信息,请参阅 检出项目(克隆)

下载依赖项

  • 在弹出窗口中点击 运行 'npm install'运行 'yarn install'

    打开应用并下载依赖项

    您可以使用 npmYarn 1Yarn 2 ,详细信息请参阅 npm 和 Yarn

  • 或者,在编辑器中的 package.json 或在 项目 工具窗口 Alt+1 的上下文菜单中,选择 运行 'npm install'运行 'yarn install'

安装用于开始使用 React Native 的其他工具,例如 iOS 模拟器。 这些工具的列表取决于您的操作系统以及您计划面向的移动平台。 有关详细的安装说明,请参阅 React Native 入门指南

项目安全

当您打开一个在 PyCharm 之外创建并导入到其中的项目时,PyCharm 会显示一个对话框,您可以在其中决定如何处理该项目及其不熟悉的源代码。

不受信任的项目警告

请选择以下选项之一:

  • 在安全模式下预览 :在这种情况下,PyCharm 以预览模式打开项目。 这意味着您可以浏览项目的源代码,但不能运行任务和脚本,也不能运行/调试您的项目。

    PyCharm 会在编辑器区域顶部显示通知,您可以随时点击 信任项目… 链接来加载您的项目。

  • 信任项目 :在这种情况下,PyCharm 会打开并加载项目。 这意味着项目已初始化、项目插件已解析、依赖项已添加,且所有 PyCharm 功能均可用。

  • 不打开 :在这种情况下,PyCharm 不会打开项目。

了解更多信息,请参阅 项目安全性

编码辅助

PyCharm 在 JavaScript 代码中为 React API 和 JSX 提供代码补全。 代码补全适用于 React 方法、React 特定属性、HTML 标签和组件名称、 React 事件 、组件属性等。 有关更多信息,请参阅 React:代码补全

运行并调试 React Native 应用

您可以在物理设备或模拟器上运行并调试您的应用。 在启动应用之前,请确保模拟器已在运行;如果使用物理设备,请确保其已连接到您的计算机。

PyCharm 使运行和调试 React Native 应用非常灵活。 例如,如果您是首次启动应用,您可以选择运行 React Native 打包器、构建应用并在模拟器上打开它——以上步骤都可作为运行或调试会话的一部分完成。 如果打包器已在运行,您也可以跳过启动;如果自上次运行以来未更改其原生代码,您可以跳过构建应用。

创建 React Native 运行/调试配置

  1. 在工具栏的 运行/调试配置 小部件中选择 编辑配置 ,点击 添加新配置 按钮(添加新配置按钮 ),并从列表中选择 React Native 以打开 配置设置

    开始创建运行/调试配置
  2. 选择是否让 PyCharm 为您构建并启动应用:

    • 如果您是首次启动应用,或自上次运行后更新过其原生代码,请选中 构建并启动 复选框。

    • 如果自上次构建以来未更改应用的原生代码,请清除此复选框。 开始调试时,PyCharm 会等待您在模拟器中打开应用,并按照 React Native 官方网站 上的说明启用远程调试。

  3. 如果您选中了 构建并启动 复选框,请选择目标平台 Android 或 iOS。

    根据您的选择,PyCharm 将使用 react-native run-iosreact-native run-android 运行打包器。

    • 要模拟 Android 平台,请使用 Android 虚拟设备

    • 要模拟 iOS 平台,您需要全局安装 ios-sim 命令行工具。 您可以通过 Node Package Manager (npm) 完成此操作,请参阅 npm、pnpm 和 Yarn ,或者根据您的操作系统运行 sudo npm install ios-sim -g 命令。

    了解更多信息,请参阅 React Native 官方网站

    可选地,在 实参 字段中输入要传递给 React Native 的参数,例如,通过 ‑‑simulator 标志指定模拟器类型: ‑‑simulator="iPhone 4s"

  4. 指定要使用的浏览器。

    在调试 React Native 应用时,PyCharm 依赖于 React Native 自身使用的 Chrome 运行时。 您还可以将 DevTools 与 PyCharm 配合使用。 当您启动调试会话时,PyCharm 会启动一个新的 Chrome 实例并附加到该实例。

  5. Bundler 主机 字段中,指定 React Native 打包器运行所在的主机,默认值为 localhost

  6. Bundler 端口 字段中,指定 React Native 打包器运行所用的端口,默认选择 8081 ;详见 React Native 官方网站

  7. 指定要使用的 Node.js 运行时。

    如果您选择 项目 别名,PyCharm 将自动使用 JavaScript Runtime 页面中 Node 运行时 字段所定义的项目默认解释器。 在大多数情况下,PyCharm 会检测到项目的默认运行时,并自动填写该字段。

    您也可以选择其他已配置的本地或远程解释器,或点击 浏览按钮 以配置新的解释器。

  8. 指定 react-native-cli 和应用的 工作目录 的路径。 可选地,输入 react-native run-androidreact-native run-ios 的环境变量。

  9. 默认情况下,PyCharm 会在您调用运行/调试配置时自动启动 React Native 打包器。 如果您已在 PyCharm 之外启动了打包器,例如通过命令行,则可以直接复用,而无需停止并重新启动。 在 启动前 区域中选择您的打包器,然后点击 移除

React Native 运行/调试配置

有关适用于所有运行/调试配置的通用设置的更多信息,请参阅 运行/调试配置

准备设备或模拟器

如果您使用的是 Android 设备,您每次开始处理应用时都需要准备该设备。

iOS 模拟器只需安装一次,此后 PyCharm 会通过 react-native run-ios 自动启动它。

  • 要准备 Android 设备,请启动一个 Android 虚拟设备 ,或启用通过 USB 的调试,并通过 USB 连接到物理 Android 设备。

    了解更多信息,请参阅 React Native 官方网站

  • 要准备 iOS 模拟器,请打开内置的 终端Alt+F12 ),然后输入:

    <nmp_path>\npm install --global ios-sim

运行应用

在工具栏的 运行/调试配置 小部件列表中,选择新建的 React Native 配置,并点击其旁边的 运行按钮。 PyCharm 会打开 运行 工具窗口,并首先在新的 React Native 选项卡中启动 React Native 打包器。

之后,将根据所选目标平台执行 react-native run-iosreact-native run-android 命令。 如果构建成功,模拟器将显示您的应用:

React Native 打包器正在运行
最后修改日期: 2025年 12月 2日