# 重构 React 应用程序

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

除了 [common IntelliJ IDEA refactorings](refactoring-source-code.html)之外，在 React 应用程序中，您还可以对 React 组件运行  Rename ，并使用  Extract Component 创建新组件。

## 重命名组件

下面是重命名仅在一个文件中定义和使用的组件的示例：

![重命名在一个文件中使用的组件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_react_rename_component.animated.gif)

同样地，您可以重命名在一个文件中定义并使用命名导出导入到另一个文件的组件：

![重命名在另一个文件中定义并通过命名导入导入的组件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_react_rename_component_from_another_file.animated.gif)

Procedure:

1. 将光标放在组件名称内并按 `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS)) 或从上下文菜单中选择  `重命名` 。

2. 请指定符合 [React 命名规范](https://reactjs.org/docs/jsx-in-depth.html#specifying-the-react-element-type)的新组件名称。

## 重命名状态值

当您重命名状态值时，IntelliJ IDEA 会建议您重命名相应的 setter（此函数在 [React useState hook](https://reactjs.org/docs/hooks-state.html) 中更新该状态值）。

![重命名状态值及相应的 setter](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_react_rename_state.animated.gif)

Procedure:

1. 将文本光标置于状态值的名称内，然后按 `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))或从主菜单或上下文菜单中选择  `重构 | 重命名` 。

2. 请指定新的值名称并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 焦点移动到 setter，其中建议了该值的新名称。 按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 接受建议。

## 提取组件

您可以通过从现有组件的 render 方法中提取 JSX 代码来创建一个新的 React 组件。 新组件可以定义为函数或类，请参阅 React 官方网站上的 [Function and Class Components](https://reactjs.org/docs/components-and-props.html#function-and-class-components)。 还可以让 IntelliJ IDEA 将新组件和所有必需的导入移动到单独的文件中。

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

Procedure:

1. 请选择您要提取的代码，然后从上下文菜单中选择  `重构 | 提取组件` 。

另外，可按 `Ctrl+Alt+Shift+T` (Windows), `⌃ T` (macOS), `⌘ ⌥ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ S` (macOS System Shortcuts), `Ctrl+Alt+Shift+T` (XWin), `Ctrl+Alt+Shift+T` (GNOME), `Ctrl+Alt+Shift+T` (KDE), `Ctrl+Alt+Shift+T` (Emacs), `Ctrl+Alt+Shift+T` (Sublime Text), `⌃ T` (Sublime Text (macOS)), `Ctrl+Shift+R` (Visual Studio), `⌘ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+T` (NetBeans), `Ctrl+Alt+Shift+T` (Eclipse), `⌃ T` (Eclipse (macOS)) 并在弹出窗口中选择   提取组件  ，或在主菜单中转到  `重构 | 提取/引入 | 提取组件` 。

2. 在打开的对话框中，指定新组件的名称及其类型。 默认情况下，将创建一个函数组件。 如果您想将新组件定义为类，请选择   类  。

3. 要将新组件和所有必需的导入移动到单独的文件，请选中   在单独的文件中创建   复选框。 默认情况下，会在当前文件旁边的同一文件夹中创建一个以新组件名称命名的新文件。 如有需要，请在   目标文件   字段中指定其他名称。

4. 点击   OK  。 IntelliJ IDEA 会创建一个新组件，并将其引用替换为先前选择的代码段。

5. 可选： 修改 IntelliJ IDEA 用于新组件的代码模板。 在   设置  对话框中( `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，转到  `编辑器 | 文件和代码模板` ，打开   代码  选项卡，并使用 [Apache Velocity 模板语言](https://velocity.apache.org/)根据需要更新模板。

## 将函数转换为类组件

通过  Convert to Class Component 重构，IntelliJ IDEA 生成一个具有您想要转换的函数名称的 ES6 类。 该类扩展了  `React .Component` ，并包含一个  `render()` 方法，其中函数体被移动。 从 [React 官方网站](https://reactjs.org/docs/state-and-lifecycle.html#converting-a-function-to-a-class) 了解更多信息。

![将函数转换为类组件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_react_convert_to_class_component.animated.gif)

Procedure:

* 将文本光标放置在要转换的函数内的任意位置，然后从主菜单或上下文菜单中选择  `重构 | 转换为类组件` 。

* 或者，按 `Ctrl+Alt+Shift+T` (Windows), `⌃ T` (macOS), `⌘ ⌥ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ S` (macOS System Shortcuts), `Ctrl+Alt+Shift+T` (XWin), `Ctrl+Alt+Shift+T` (GNOME), `Ctrl+Alt+Shift+T` (KDE), `Ctrl+Alt+Shift+T` (Emacs), `Ctrl+Alt+Shift+T` (Sublime Text), `⌃ T` (Sublime Text (macOS)), `Ctrl+Shift+R` (Visual Studio), `⌘ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+T` (NetBeans), `Ctrl+Alt+Shift+T` (Eclipse), `⌃ T` (Eclipse (macOS))，然后从弹出窗口中选择   转换为类组件  。

## 将类转换为函数组件

使用  Convert to Functional Component  重构，IntelliJ IDEA 会生成一个具有您要转换的类名的函数，并将  `render()`  方法的内容移至函数体。

![将类转换为函数组件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_react_convert_to_functional_component.animated.gif)

Procedure:

* 将文本光标置于要转换的类中的任意位置，然后选择主菜单或上下文菜单中的  `重构 | 转换为函数组件` 。

* 或者，按 `Ctrl+Alt+Shift+T` (Windows), `⌃ T` (macOS), `⌘ ⌥ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ S` (macOS System Shortcuts), `Ctrl+Alt+Shift+T` (XWin), `Ctrl+Alt+Shift+T` (GNOME), `Ctrl+Alt+Shift+T` (KDE), `Ctrl+Alt+Shift+T` (Emacs), `Ctrl+Alt+Shift+T` (Sublime Text), `⌃ T` (Sublime Text (macOS)), `Ctrl+Shift+R` (Visual Studio), `⌘ ⇧ R` (Visual Studio (macOS)), `Ctrl+Alt+Shift+T` (NetBeans), `Ctrl+Alt+Shift+T` (Eclipse), `⌃ T` (Eclipse (macOS))，然后从弹出窗口中选择   转换为函数组件  。

## 在 React 应用中的解构

析构可让你轻松地将数组和对象中的值解压缩到变量中。 此功能性具有非常简洁的语法，通常在需要在应用程序中传递数据时使用。

在使用 React 类组件时，考虑使用  Introduce object/array destructuring  意图操作。 了解更多关于 [JavaScript 解构](specific-javascript-refactorings.html#ws_js_introduce_object_or_array_destructuring)的信息。

![使用意图操作进行析构：在 React 类中引入对象析构](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ws_js_destructuring_react_class_706.animated.gif)

