# React

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> 必需插件  :
>
>
>
> `React` ，  `Vite`  - 插件与 CLion 捆绑，并默认启用。
>
>
>
> `JavaScript Debugger`  -  插件与 CLion 捆绑在一起，并默认启用。

React  是一个用于从封装组件构建复杂交互用户界面的 JavaScript 库。 了解更多有关该库的信息，请访问 [React 官方网站](https://facebook.github.io/react/)。

CLion 集成了 React，提供配置、编辑、linting、运行、调试和维护您的应用程序的帮助。

## 在开始之前

Procedure:

1. 请确保您的计算机上安装了 [Node.js](http://nodejs.org/)。

2. 确保  JavaScript 和 TypeScript 和  JavaScript 调试器 所需插件已在   设置 | 插件  页面上启用。 有关更多信息，请参阅 [管理插件](managing-plugins.html)。

3. 安装  React 和  Vite 插件，在   设置 | 插件  页面上进行，如 [从 JetBrains Marketplace 安装插件](managing-plugins.html#install_plugin_from_repo)中所述。

## 创建一个新的 React 应用程序

> **Note:**
> 启动新的 React 单页应用程序的推荐方法是 [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite)包，CLion 会为您下载并使用 [npx](https://www.npmjs.com/package/npx)运行它。 结果，您的开发环境已预配置为使用 Vite 和 React 以及 TypeScript，了解更多信息请参阅 [Vite 官方网站](https://blog.logrocket.com/build-react-typescript-app-vite/#benefits-using-react-vite)。

### 生成 React 应用程序。

Procedure:

1. 点击   新项目   屏幕上的   欢迎   或从主菜单中选择  `文件 | 新建 项目` 。 “ [新建 项目 对话框](null)”打开。

2. 在左侧窗格中，选择   React  。

3. 在右侧窗格中：

1.

指定存储与项目相关的文件的文件夹路径。

2.

在   Node.js 运行时   字段中，指定要使用的 Node.js 运行时。 从列表中选择一个已配置的运行时，或选择   Add   以配置新的运行时。

3.

从   React CLI   列表中选择要使用的生成器。

* 接受默认的 `[npx create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite)` ，即可预先为使用 Vite 配置您的开发环境。

* 选择 `[npx create-react-app](https://github.com/facebook/create-react-app)` ，即可预先为使用 webpack、Babel 和 ESLint 配置您的开发环境。

* 要使用自定义的已下载生成器，请点击 Select ，并在打开的对话框中指定生成器的路径。

![创建 React 应用程序 - 选择生成器](https://resources.jetbrains.com/help/img/idea/2026.3/react_create_project_select_generator.png)

4.

可选：

要使用 TSX 而不是 JSX，请选择   创建 TypeScript 项目   复选框。 CLion 将为您的应用生成  `.tsx` 文件以及一个  `tsconfig.json` 配置文件。

4. 当您点击   创建  时，CLion会生成一个  React  特定项目，并包括所有必需的配置文件和下载所需的依赖项。 CLion 还会创建一个  npm start  和  JavaScript Debug  配置，使用默认设置来运行或调试您的应用程序。

> **Tip:**
> 或者，打开内置的   终端  ，输入  `npm create vite@latest`  创建一个应用程序，然后回答向导中的问题，了解更多信息请访问 [Vite 官方网站](https://blog.logrocket.com/build-react-typescript-app-vite/#creating-vite-project)。

### 在一个空的 CLion 项目中安装 React

在这种情况下，您将需要按照下文 [构建 React 应用程序](#react_compiling_application)中的描述自行配置构建管道。 从 [React 官方网站](https://react.dev/)了解更多关于将 React 添加到项目中的信息。

Procedure: 创建一个空的 CLion 项目

1. 点击   新项目   屏幕上的   欢迎   或从主菜单中选择  `文件 | 新建 项目` 。 “ [新建 项目 对话框](null)”打开。

2. 在左侧窗格中，选择   空的 项目  。 在右侧窗格中，指定应用程序文件夹并点击   创建  。

Procedure: 在空项目中安装 React

1. 打开您将使用  React  的空项目。

2. 在命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）中输入：

`npm install --save react react-dom`

## 从现有的 React 应用程序开始

要继续开发现有的 React 应用程序，请在 CLion 中打开并下载所需的依赖项。

Procedure: 打开您机器上已有的应用程序源代码

* 点击   打开   屏幕上的   欢迎   或从主菜单中选择  `文件 | 打开` 。 在打开的对话框中，选择存储源文件的文件夹。

Procedure: 从您的版本控制中检出应用程序源代码

1. 在   欢迎   屏幕上单击   克隆存储库  。

或者，从主菜单中选择  `文件 | 新建 | 从版本控制创建项目…`  或  `Git | 克隆…`  或  `VCS | 从版本控制获取` 。

您可能会看到与您的项目相关联的其他版本控制系统，而不是在主菜单中的   Git  。 例如，   Mercurial   或   Perforce  。

2. 在打开的对话框中，从列表中选择您的版本控制系统，并指定要从中检出的应用程序源代码的存储库。 如需了解更多信息，请参见 [Check out a project (clone)](manage-projects-hosted-on-github.html#clone-from-GitHub)。

Procedure: 下载依赖项

* 请点击   运行 'npm install'   或   运行 'yarn install'   在弹出窗口中：

![打开应用并下载依赖项](https://resources.jetbrains.com/help/img/idea/2026.3/ws_npm_yarn_package_run_npm_install.png)

您可以使用 [npm](https://docs.npmjs.com/)、 [Yarn 1](https://classic.yarnpkg.com/lang/en/) 或 [Yarn 2](https://yarnpkg.com/)，详情请参阅 [npm 和 Yarn](installing-and-removing-external-software-using-node-package-manager.html)。

* 或者，在编辑器或   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中打开  `package.json`  的上下文菜单，然后选择   运行 'npm install'   或   运行 'yarn install'  。

### 项目安全性

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

请选择以下选项之一：

* 安全模式中预览 ：在这种情况下，CLion 以预览模式打开项目。 这意味着您可以浏览项目的源代码，但不能运行任务和脚本或运行/调试您的项目。 CLion 会在编辑器区域顶部显示一条通知，您可以随时点击 信任项目… 链接并加载您的项目。

* 信任项目 ：在这种情况下，CLion 会打开并加载一个项目。 这意味着项目已经初始化，项目的插件已解析，依赖项已添加，并且所有 CLion 功能都可用。

* 请勿打开 ：在这种情况下，CLion 不会打开项目。

请从 [项目安全性](project-security.html) 了解更多。

> **Tip:**
> 从欢迎屏幕或通过  `文件 | 新建 | 项目`  创建的项目（如描述中所述）会自动被视为受信任。

## 代码补全

CLion 为 JavaScript 代码中的 React APIs 和 [JSX](https://reactjs.org/docs/introducing-jsx.html) 提供代码补全。 代码补全适用于 React 方法、React 特定属性、HTML 标签和组件名称、 [React events](https://facebook.github.io/react/docs/events.html#supported-events)、组件属性等。 请访问 [React 官方网站](https://facebook.github.io/react/docs/dom-elements.html)了解更多信息。

要获得 React 方法和 React 特定属性的代码补全，您需要在项目中的某个地方包含  `react.js`  库文件。 通常库已经在您的  `node_modules` 文件夹中。

### 完整的 React 方法、属性和事件

默认情况下，代码补全弹窗会在您输入时自动显示。 例如：

![完成弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_completion_methods_and_attributes.png)

在 JSX 标签中，CLion 为 [特定于 React 的属性](https://facebook.github.io/react/docs/dom-elements.html)（例如  `className`  或  `classID` ）以及 [非 DOM 属性](https://facebook.github.io/react/docs/dom-elements.html)（例如  `key`  或  `ref` ）提供编码辅助。 此外，自动完成功能还适用于项目的 CSS 文件中定义的类名：

![CSS 类名补全](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_classname.png)

所有 [React 事件](https://facebook.github.io/react/docs/events.html#supported-events)，例如  `onClick` 或  `onChange` ，也可以在一起完成的大括号   `={}` 或引号  `""` 。

![完成 React 事件](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_events.animated.gif)

默认情况下，会插入花括号。 您可以让 CLion 始终添加引号，或根据 [TypeScript definition file (d.ts)](https://github.com/DefinitelyTyped/DefinitelyTyped) 的类型在引号和花括号之间选择。 要更改默认设置，请打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 代码风格 | HTML`  并从   为 JSX 属性添加   列表中选择适用的选项。

![为 JSX 属性添加](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_add_braces.png)

代码补全同样适用于大括号内的 JavaScript 表达式。 这适用于你定义的所有方法和函数。

![在大括号内完成 JavaScript 表达式](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_javascript_expression.png)

### 完成 HTML 标签和组件名称

CLion 为你在 JavaScript 方法中或其他组件内部定义的 HTML 标记和组件名称提供代码补全。

![HTML 标签和组件名称的自动完成](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_component_completion.png)

补全同样适用于使用 ES6 风格语法导入的组件。

![使用 ES6 语法的导入组件完成](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_imported_component_completion.png)

### 完成组件属性

CLion 为使用  `propTypes`  定义的组件属性提供代码补全，并解析这些属性，方便你快速跳转或预览它们的定义。

![组件属性的补全](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_component_properties.animated.gif)

当您自动完成组件的名称时，CLion 会自动添加它的所有必需属性。 如果某个组件的使用中缺少一些必需的属性，CLion 会提醒您。

## 为函数式组件添加状态

CLion 通过在特定位置定义未解析的引用，建议快速修复以向函数式 React 组件添加  `[useState](https://react.dev/reference/react/useState)`  钩子。 CLion 会自动为  `useState`  钩子插入  `import`  语句。 状态的类型将根据定义该引用的位置进行推断。

> **Note:**
> * 该功能仅在 `.tsx` 文件中的函数式 React 组件主体内可用。
>
> * 该功能不适用于类组件。

Procedure:

* 将插入符号置于未解析的引用处，按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))，然后在列表中选择   在 < functional component name> 组件中创建 <unresolved reference> 状态  。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_state.mp4)

## 添加属性

CLion 通过在特定位置定义未解析的引用，建议快速修复以向 React 组件添加新属性。

CLion 会生成包含新增属性的组件代码。 属性的类型将根据定义相应引用的位置进行推断。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_props.mp4)

该快速修复也可用于类组件。 在此类情况下，在插入新属性后，未解析的引用将被替换为  `this.props.${reference_name}` 。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_props_class.mp4)

> **Note:**
> 该功能仅在  `.tsx`  文件中可用。

Procedure:

* 将插入符号置于未解析的引用处，按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))，然后在列表中选择   在 <component name> 组件中创建 <unresolved reference> 属性  。

![添加属性](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_props_steps.png)

## 将 HTML 属性转移到 JSX

当您复制带有类属性或事件处理程序的 HTML 代码并将其粘贴到 JSX 中时，CLion 会自动将这些属性替换为特定于 React 的属性（  `className` 、  `onClick` 、  `onChange` 等）。

![将 HTML 转换为 JSX](https://resources.jetbrains.com/help/img/idea/2026.3/ws_paste_from_html_to_jsx.animated.gif)

这也适用于 TSX：

![将 HTML 转换为 TSX](https://resources.jetbrains.com/help/img/idea/2026.3/ws_paste_from_html_to_tsx.animated.gif)

当您将包含单标签的 HTML 代码片段复制并粘贴到 JSX 中时，CLion 会在每个单标签的末尾自动添加斜杠  `/` 。

![将 HTML 转换为 JSX：关闭单标签](https://resources.jetbrains.com/help/img/idea/2026.3/ws_paste_from_html_to_jsx_close_tags.animated.gif)

要将 HTML 代码按原样复制到 JSX 或 TSX，请使用  Paste Simple  `Ctrl+Alt+Shift+V` (Windows), `⌘ ⌥ ⇧ V` (macOS), `⌘ ⌥ ⇧ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ V` (macOS System Shortcuts), `Ctrl+Alt+Shift+V` (XWin), `Ctrl+Alt+Shift+V` (GNOME), `Ctrl+Alt+Shift+V` (KDE), `Ctrl+Alt+Shift+V` (Emacs), `Ctrl+V` (Sublime Text), `⌘ V` (Sublime Text (macOS)), `⌘ ⌥ ⇧ V` (Xcode), `Ctrl+Alt+Shift+V` (Visual Studio), `⌘ ⌥ ⇧ V` (Visual Studio (macOS)), `Ctrl+Alt+Shift+V` (ReSharper), `⌘ ⌥ ⇧ V` (ReSharper (macOS)), `Ctrl+Alt+Shift+V` (QtCreator), `⌘ ⌥ ⇧ V` (QtCreator (macOS)), `Ctrl+Alt+Shift+V` (NetBeans), `Ctrl+Alt+Shift+V` (Eclipse), `⌘ ⌥ ⇧ V` (Eclipse (macOS)) 或打开   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 常规 | 智能键 | JavaScript`  设置页面并清除   将 HTML 单标签粘贴到 JSX 文件时自动闭合   和   粘贴到 JSX 文件时转换 HTML 属性名称   复选框。

## React 代码片段

CLion 带有超过 50 个代码片段的集合，这些片段扩展为 React 应用中常用的不同语句和代码块，包括 [React Hooks](https://react.dev/reference/react)。 下面的示例展示了如何使用  rcjc  缩写创建一个定义新 React 组件的类：

![React 组件的实时模板](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_live_template.animated.gif)

### 从代码片段创建一个 React 代码结构

Procedure:

* 请在编辑器中输入所需的缩写并按下 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `⇥` (Xcode), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (ReSharper), `⇥` (ReSharper (macOS)), `Tab` (QtCreator), `⇥` (QtCreator (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS))。

* 按 `Ctrl+J` (Windows), `⌘ J` (macOS), `⌘ J` (IntelliJ IDEA Classic (macOS)), `⌘ J` (macOS System Shortcuts), `Ctrl+J` (XWin), `Ctrl+J` (GNOME), `Ctrl+J` (KDE), `Ctrl+J` (Emacs), `Ctrl+J` (Sublime Text), `Ctrl+J` (Sublime Text (macOS)), `⌘ J` (Xcode), `Ctrl+K, X` (Visual Studio), `⌘ E, L` (Visual Studio (macOS)), `Ctrl+J` (ReSharper), `⌘ J` (ReSharper (macOS)), `Ctrl+J` (QtCreator), `Ctrl+J` (QtCreator (macOS)), `Ctrl+J` (NetBeans), `Ctrl+Alt+Shift+J` (Eclipse), `Ctrl+J` (Eclipse (macOS)) 并选择相关的代码片段。 为了缩小搜索作用域，开始输入缩写，然后从 [补全列表](auto-completing-code.html)中选择。

如需更多信息，请参阅 [实时模板](using-live-templates.html)。

### 查看所有可用的 React 代码片段列表

Procedure:

* 在   设置   对话框 ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 中，点击   活动模板   下的   编辑器  ，然后展开   React   或   React hooks   节点。

![React 和 React hooks 活动模板](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_code_snippets.png)

## React 指令

CLion 能够识别并高亮显示文件顶部及函数内的以下 [React 指令](https://react.dev/reference/react-compiler/directives)：

* [use client](https://react.dev/reference/rsc/use-client)

* [use server](https://react.dev/reference/rsc/use-server)

* [use memo](https://react.dev/reference/react-compiler/directives/use-memo)

* [use no memo](https://react.dev/reference/react-compiler/directives/use-no-memo)

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_directives_highlight.mp4)

## JSX 中的 Emmet

通过 CLion，您不仅可以在 HTML 中使用 [Emmet](https://docs.emmet.io/cheat-sheet/)，还可以在 JSX 代码中利用一些特别的 React 变体进行使用。 例如，缩写  div.my-class  在 JSX 中会扩展为  `<div className=”my-class"></div>` ，但不会像在 HTML 中那样扩展为  `<div class=”my-class"></div>` 。

![在 React 中扩展 Emmet 模板](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_emmet.animated.gif)

## 浏览 React 应用程序

除了 [基本导航](navigating-through-the-source-code.html)之外，CLion 还能帮助您在 React 特定的代码元素之间跳转。

Procedure:

* 要跳转到方法的声明或大括号内的 JavaScript 表达式  `{}` ，请选择方法或表达式并按 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS))。

要跳转到组件声明，选中组件名称并按下 `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS))。

* 若要查看组件定义，请按 `Ctrl+Shift+I` (Windows), `⌥ Space` (macOS), `⌘ ⇧ I` (IntelliJ IDEA Classic (macOS)), `⌘ Y` (macOS System Shortcuts), `Ctrl+Shift+I` (XWin), `Ctrl+Shift+I` (GNOME), `Ctrl+Shift+I` (KDE), `Ctrl+Shift+I` (Emacs), `Ctrl+Shift+I` (Sublime Text), `⌥ Space` (Sublime Text (macOS)), `⌃ F1` (Xcode), `Alt+F12` (Visual Studio), `⌥ Space` (Visual Studio (macOS)), `Ctrl+Shift+I` (ReSharper), `⌥ Space` (ReSharper (macOS)), `Ctrl+Shift+I` (QtCreator), `Ctrl+Shift+I` (QtCreator (macOS)), `Ctrl+Shift+I` (NetBeans), `Ctrl+Shift+I` (Eclipse), `⌥ Space` (Eclipse (macOS))。 从 [定义和类型定义](viewing-definition.html)了解更多。

![在弹出窗口中查看组件的快速定义](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_quick_definition.png)

* 要查看组件的快速文档，请按 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))。 从 [JavaScript 文档查找](viewing-javascript-reference.html)了解更多。

![React 组件的快速文档弹出窗口](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_quick_doc.png)

* CLion 允许您通过 [编辑器导航路径](using-code-editor.html#breadcrumbs) 和编辑器边栏中的彩色高亮轻松浏览 JSX 标签。

![React 应用中的 JSX 标签高亮和导航路径](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_jsx_tree_highlighting.png)

### 使用结构视图进行导航

结构   工具窗口与   结构   弹出窗口可帮助您更清晰地洞察 React 代码结构，便于导航并促进对 React 组件及相关元素的更好理解。

结构   工具窗口显示以下特定于 React 的节点：

* 带有其名称的 JSX 和 TSX 标签。

* React 组件 节点显示 React 组件声明。 对于每个符合 [React 组件定义](https://react.dev/learn/your-first-component) 的类或函数都会创建单独的节点。 ![结构视图——组件节点](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_component.png)

* React hook 节点表示 React 钩子声明。 对于 React 组件内部每个符合 [Hook 规则](https://react.dev/warnings/invalid-hook-call-warning) 的函数调用，都会创建单独的节点。 每个节点都会显示钩子的名称及其泛型类型。 由钩子初始化的变量会作为其节点下的子节点显示。 ![结构视图——钩子节点](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_hooks.png) 对于以 `[variableName, setVariableName]` 格式返回 2 个变量的钩子，会在钩子名称旁以灰色显示变量名： ![结构视图——带有 setVariable 的钩子](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_hooks_setVariable.png)

* 条件 节点表示条件渲染的 JSX 标签节点。 不包含 JSX 的条件不会显示。 ![结构视图——条件节点](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_conditional.png)

* 属性 节点表示其他组件属性内的 JSX。 不包含 JSX 的属性不会显示。 ![结构视图——属性节点](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_attribute.png)

* 数组 节点表示包含 JSX 的数组。 ![结构视图——数组节点](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_array.png)

* 变量 节点表示包含 JSX 的变量。

* Map 节点表示 JSX 内容中的数组 map。 ![结构视图—— map 节点](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_map.png)

Procedure:

* 要打开   结构   工具窗口，请按 `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `⌘ 3` (Xcode), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+F11` (ReSharper), `⌃ F11` (ReSharper (macOS)), `Alt+7` (QtCreator), `⌘ 7` (QtCreator (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS))，或在主菜单中转到  `视图 | 工具窗口 | 结构` 。

* 要打开   结构   弹出窗口，请按 `Ctrl+F12` (Windows), `⌘ F12` (macOS), `⌘ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ 7` (macOS System Shortcuts), `Ctrl+F12` (XWin), `Ctrl+F12` (GNOME), `Ctrl+0` (KDE), `Ctrl+F12` (Emacs), `Ctrl+R` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `⌃ 6` (Xcode), `Alt+\` (Visual Studio), `⌥ \` (Visual Studio (macOS)), `Ctrl+F12` (ReSharper), `⌘ F12` (ReSharper (macOS)), `Ctrl+F12` (QtCreator), `⌘ F12` (QtCreator (macOS)), `Ctrl+F12` (NetBeans), `Ctrl+F3` (Eclipse), `⌘ O` (Eclipse (macOS))，或在主菜单中转到  `导航 | 文件结构` 。

* 结构   工具窗口与   结构   弹出窗口会与活动编辑器选项卡中的文件同步。 在结构视图中移动时，文件中的相应代码元素会被高亮显示。 此外，如果您在源代码中重命名某个项目，相应的节点也会随之更新。

要从结构视图中的某个项目跳转到源代码，请按 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。

详细了解请参阅 [源代码导航：文件结构](null)。

## 检查 React 应用程序

所有 CLion 内置的 [代码检查](code-inspection.html) 也适用于 JSX 代码中的 JavaScript 和 HTML。 CLion 会提醒您未使用的变量和函数、缺少的关闭标签、缺少的语句等。

![React 应用中的 JavaScript 检查](https://resources.jetbrains.com/help/img/idea/2026.3/禁用和抑制检查](disabling-and-enabling-inspections.html)和 [检查严重性](configuring-inspection-severities.html)中了解更多信息。

### ESLint

除了提供内置代码检查之外，CLion 还与 [ESLint](http://eslint.org/) 等 linter 集成，用于 JSX 代码。 ESLint 带来了一系列广泛的代码检查规则，这些规则也可以通过插件进行扩展。 CLion 在编辑器中直接显示 ESLint 报告的警告和错误，实时更新。 使用 ESLint，您还可以使用 [JavaScript Standard Style](https://standardjs.com/) 并 [lint 您的 TypeScript 代码](linting-typescript.html#ws_eslint_linting_typescript_files_with_eslint_intro)。

欲了解更多信息，请参阅 [ESLint](eslint.html)。

要让 ESLint 正确理解 React JSX 语法，您需要 [eslint-plugin-react](https://www.npmjs.com/package/eslint-plugin-react)。 使用此插件，您会收到警告，例如，当 React 组件没有设置显示名称，或者使用了一些危险的 JSX 属性时：

![使用 React 的 ESLint：错误和警告会被高亮显示，问题的描述会显示在工具提示中。](https://resources.jetbrains.com/help/img/idea/2026.3/ws_eslint_react.png)

> **Tip:**
> 如果您 [使用 create-react-app 创建了您的应用程序](#creating_react_app_with_generators)，您的开发环境已经预配置为使用 ESLint。

Procedure: 在 React 项目中安装和配置 ESLint

1. 在内置   终端   (  `视图｜工具窗口｜终端` ) 中，键入：

```
npm install --save-dev eslint
npm install --save-dev eslint-plugin-react

```

2. 将 [ESLint 配置文件](eslint.html#ws_eslint_configuration_file_format) 添加到您的项目中。

3. 在   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，进入   语言与框架 | JavaScript | 代码质量工具 | ESLint  ，然后选择   自动 ESLint 配置  。 CLion 会自动在您的项目  `node_modules`  文件夹中定位 ESLint，然后从  `.eslintrc.*`  文件或  `package.json` 中的  `eslintConfig`  属性使用默认配置。

或者，选择   手动 ESLint 配置  使用自定义 ESLint 程序包和配置。

请参见 [在 CLion 中激活和配置 ESLint](eslint.html#ws_js_eslint_activate) 了解详细信息。

Procedure: ESLint 1.x 版本与 react 插件的 .eslintrc 结构示例

1. 在  `ecmaFeatures`  对象中，添加  `"jsx" = true` 。 在这里，您还可以指定想要使用的其他语言功能，例如，ES6 classes、modules等。

2. 在  `plugins`  对象中，添加  `react` 。

3. 在  `rules` 对象中，您可以列出希望启用的 [ESLint 内置规则](http://eslint.org/docs/rules/)以及 [通过 react 插件提供的规则](https://github.com/yannickcr/eslint-plugin-react#list-of-supported-rules)。

```JSON
{
  "parser": "babel-eslint",
  "env": {
    "browser": true,
    "es6": true,
    "jest": true
  },

  "rules": {
    "arrow-parens": ["error", "as-needed", {
      "requireForBlockBody": true
    }],
    "react/jsx-props-no-spreading": "off",
    "react/jsx-sort-props": ["error", {
      "reservedFirst": ["key"]
    }],
    "react/require-default-props": "off",
    "react/sort-prop-types": "error",
    "react/state-in-constructor": ["error", "never"],
    "semi-spacing": "warn"
  },
  "overrides": [
    {
      "files": [
        "sample/**",
        "test/**"
      ],
      "rules": {
        "import/no-unresolved": "off"
      }
    }
  ]
}                
```

了解更多关于 ESLint 和  `react`  插件配置的信息，请访问 [ESLint 官方网站](http://eslint.org/docs/2.0.0/user-guide/configuring.html#specifying-parser-options)。

## 构建一个 React 应用程序

如果您 [在现有的 CLion 项目中安装了 React](#install_react_in_empty_project)，需要设置构建过程。 了解各种为您的 React 应用配置构建流水线的方法，详情请参阅 [React 官方网站](https://react.dev/)。

> **Tip:**
> 如果您 [使用 create-vite 创建了应用程序](#creating_react_app_with_generators)，您的开发环境已经预配置为使用 Webpack 和 Babel。

## 在一个项目中使用多个框架

有时，您可能需要在一个 React 项目中使用其他框架。

要在每个文件中获得上下文感知的编码辅助，请创建一个配置文件  `.ws-context` ，并指定每个特定文件或文件夹应使用的框架。 此文件中的设置将重写默认配置。

Procedure:

1. 在项目根目录中，从上下文菜单中选择   新建文件  并将文件名指定为  `.ws-context` 。

2. 在  `.ws-context` 中，使用两种属性：

* `<context-name>` 带有上下文值字符串

* 具有上下文详情对象的 GLOB 模式

3. 使用以下上下文值：

* `framework` ： `vue` 、 `angular` 、 `react` 、 `svelte` 、 `astro`

* `angular-template-syntax` ： `V_2` `V_17`

* `nextjs-project` ： `nextjs`

* `astro-project` ： `astro`

* `vue-store` ： `vuex` `pinia`

* `vue-class-component-library` ： `vue-class-component` 、 `vue -property-decorator` 、 `vue-facing-decorator`

* `jsdoc-dialect` ： `jsdoc-typescript` `jsdoc-closure`

4. 使用路径嵌套以简化操作。

* GLOB 路径的最后一段是文件名模式，它仅支持 `*` 通配符。

* 如果最后一个段是一个 `**` ，它匹配所有嵌套的目录和文件。

* 顶层上下文属性应具有 `/**` 模式。

5. 当多个模式匹配相同文件名时，将使用以下规则进行消歧：

* 选择路径段数最多的模式，排除 `**` 段。

* 选择纯文件名模式，这意味着它不会以 `**` 或 `/` 结尾。

* 选择最先定义的模式。

### 示例

假设您有一个项目，其中在各个文件夹中使用了多个框架。

![具有不同框架的项目](https://resources.jetbrains.com/help/img/idea/2026.3/several_frameworks_context_project_structure.png)

要为项目中的每个文件获得上下文相关的帮助，请将以下代码添加到  `.ws-context` :

```JSON
{
  "framework": "vue",
  "angular-template-syntax": "V_2",
  "src/**/app/**": {
    "framework": null,
    "app.component.html" : {
      "framework": "angular",
      "angular-template-syntax": "V_17"
    }
  },
  "src/**/p*-editor/*.html" : {
    "framework" : "angular"
  }
}
        
```

## See also

### 语言和框架特定指南

[JavaScript](javascript-specific-guidelines.html) [配置 JavaScript 库](configuring-javascript-libraries.html) [TypeScript](typescript-support.html)

### 参考

[JavaScript](settings-languages-javascript.html)

### 外部链接

[Working with React in WebStorm: Coding Assistance](http://blog.jetbrains.com/webstorm/2015/10/working-with-reactjs-in-webstorm-coding-assistance/)

