# 提取/引入变量

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

> **TL;DR**
> `重构 | 提取/引入 | 变量`
>
>
>
> `Ctrl+Alt+V` (Windows), `⌘ ⌥ V` (macOS), `⌘ ⌥ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ V` (macOS System Shortcuts), `Ctrl+Alt+V` (XWin), `Ctrl+Alt+V` (GNOME), `Alt+Shift+V` (KDE), `Ctrl+Alt+V` (Emacs), `Ctrl+Alt+V` (Sublime Text), `Ctrl+Alt+V` (Sublime Text (macOS)), `Ctrl+R, V` (Visual Studio), `⌘ R, V` (Visual Studio (macOS)), `Alt+Shift+V` (NetBeans), `Alt+Shift+L` (Eclipse), `⌘ ⌥ L` (Eclipse (macOS))

如果遇到难以理解的表达式，或者它在代码中的多个位置重复出现，  提取变量 重构 `Ctrl+Alt+V` (Windows), `⌘ ⌥ V` (macOS), `⌘ ⌥ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ V` (macOS System Shortcuts), `Ctrl+Alt+V` (XWin), `Ctrl+Alt+V` (GNOME), `Alt+Shift+V` (KDE), `Ctrl+Alt+V` (Emacs), `Ctrl+Alt+V` (Sublime Text), `Ctrl+Alt+V` (Sublime Text (macOS)), `Ctrl+R, V` (Visual Studio), `⌘ R, V` (Visual Studio (macOS)), `Alt+Shift+V` (NetBeans), `Alt+Shift+L` (Eclipse), `⌘ ⌥ L` (Eclipse (macOS))可以帮助将此类表达式或其一部分的结果放入一个复杂度更低且更易理解的单独变量中，从而解决这些问题。 另外，它减少了代码重复。

从 Java 1.8 及更高版本开始，IntelliJ IDEA 还允许您 [提取一个功能类型变量](#extract_functional_variable)。

如果您的 Java 版本支持 [模式匹配](http://cr.openjdk.java.net/~gbierman/jep305/jep305-20191021/specs/patterns-instanceof-jls.html)（Java 14 预览版或更高版本），并且您正在提取  `instanceof` 检查下的强制转换表达式，IntelliJ IDEA 可能会在该  `instanceof` 检查中引入一个模式变量，而不是普通的局部变量。 此外，您可以从 Java 14 版本开始内联模式变量。 在这种情况下，所有出现位置都将被替换为旧式强制类型转换表达式。

可以使用  引入变量  重构将可变实参提取到新的切片变量中。

Procedure:

1. 在编辑器中，选择要提取的表达式或其一部分。 您还可以将文本光标放在表达式内，在这种情况下，IntelliJ IDEA 会为您提供一个潜在代码选择列表。

2. 按 `Ctrl+Alt+V` (Windows), `⌘ ⌥ V` (macOS), `⌘ ⌥ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ V` (macOS System Shortcuts), `Ctrl+Alt+V` (XWin), `Ctrl+Alt+V` (GNOME), `Alt+Shift+V` (KDE), `Ctrl+Alt+V` (Emacs), `Ctrl+Alt+V` (Sublime Text), `Ctrl+Alt+V` (Sublime Text (macOS)), `Ctrl+R, V` (Visual Studio), `⌘ R, V` (Visual Studio (macOS)), `Alt+Shift+V` (NetBeans), `Alt+Shift+L` (Eclipse), `⌘ ⌥ L` (Eclipse (macOS)) 或在主菜单中转到  `重构 | 提取/引入 | 变量` 。

或者，在出现的 [工具栏](working-with-source-code.html#floating_toolbar) 上，点击   提取   并选择   变量  。

IntelliJ IDEA 还会在变量旁边显示 ![齿轮图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)，您可以使用它来配置更多选项。

![更多选项](https://resources.jetbrains.com.cn/help/img/idea/2026.3/introduce_var_more_options.png)

如果 IntelliJ IDEA 找到多个匹配项，您可以指定范围，仅提取找到的部分匹配项，而不是全部。

![引入变量出现范围](https://resources.jetbrains.com.cn/help/img/idea/2026.3/introduce_variable_occurrences_scope.png)

3. 在弹出窗口中选择一个建议的名称或输入自己的名称，然后按 `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))。

![提取变量](https://resources.jetbrains.com.cn/help/img/idea/2026.3/extract_var.png)

您还可以将您提取的变量声明为  `final` 。

如果您想要将现有变量重新分配给新的变量，请按 `Ctrl+Alt+V` (Windows), `⌘ ⌥ V` (macOS), `⌘ ⌥ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ V` (macOS System Shortcuts), `Ctrl+Alt+V` (XWin), `Ctrl+Alt+V` (GNOME), `Alt+Shift+V` (KDE), `Ctrl+Alt+V` (Emacs), `Ctrl+Alt+V` (Sublime Text), `Ctrl+Alt+V` (Sublime Text (macOS)), `Ctrl+R, V` (Visual Studio), `⌘ R, V` (Visual Studio (macOS)), `Alt+Shift+V` (NetBeans), `Alt+Shift+L` (Eclipse), `⌘ ⌥ L` (Eclipse (macOS))。 如果您有多个现有变量，IntelliJ IDEA 将显示一个供选择的列表。

您可以按 `Shift+Tab` (Windows), `⇧ ⇥` (macOS), `⇧ ⇥` (IntelliJ IDEA Classic (macOS)), `⇧ ⇥` (macOS System Shortcuts), `Shift+Tab` (XWin), `Shift+Tab` (GNOME), `Shift+Tab` (KDE), `Shift+Tab` (Emacs), `Shift+Tab` (Sublime Text), `⇧ ⇥` (Sublime Text (macOS)), `Shift+Tab` (Visual Studio), `⇧ ⇥` (Visual Studio (macOS)), `Shift+Tab` (NetBeans), `Shift+Tab` (Eclipse), `⇧ ⇥` (Eclipse (macOS)) 来更改变量的类型。

![将变量声明为 final](https://resources.jetbrains.com.cn/help/img/idea/2026.3/change_type_for_var.png)

默认情况下，此提取重构将在编辑器中应用。 要更改您的设置以通过 [模态窗口](extract-variable-refactoring-dialog.html)应用重构，请打开   设置  对话框（ `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))），转到   编辑器 | 代码编辑  ，并在   重构  区域选择   在模态对话框中  。

## 示例

我们来提取代码中两次出现的  `anotherClass.inValue()`  变量并为其命名  `number` 。

Java:

|  之前  |  之后  |
| --- | --- |
|     ```JAVA public void method() {     int a = 1; ...     int b = a + anotherClass.intValue();     int c = b + anotherClass.intValue(); }                              ```    |     ```JAVA public void method() {     int a = 1; ...     int number = anotherClass.intValue();     int b = a + number;     int c = b + number; }                              ```    |

Kotlin:

|  之前  |  之后  |
| --- | --- |
|     ```ACTIONSCRIPT func method() {      val a = 1      val b = a + anotherClass!!.intValue()      val c = b + anotherClass!!.intValue() }                                  ```    |     ``` func method() {      val a = 1      val number = anotherClass!!.intValue()      val b = a + number      val c = b + number }                                  ```    |

## 提取函数变量

此重构为 Java 1.8 及更高版本创建了函数表达式，为较旧版本的 Java 创建了匿名类。

Procedure:

1. 选择代码片段，在本例中是  `打印行`  方法的参数。

![argument_println.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/argument_println.png)

2. 在主菜单中，前往  `重构 | 提取/引入 | 函数组件` 。

IntelliJ IDEA 打开   提取功能变量  对话框。

或者，您也可以从编辑器中的上下文菜单中选择  `重构 | 对此进行重构`  `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))，然后选择   功能变量  。

![extrct_funtional_var.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/extrct_funtional_var.png)

3. 当所选代码依赖于实例字段时，例如在此示例中，会出现   将字段作为参数传递   复选框，您可以在字段位置传递一个参数。

![extrct_funtional_var_parameter.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/extrct_funtional_var_parameter.png)

但是，例如，如果您选择的代码片段依赖于任何局部变量或参数

![sample_string.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sample_string.png)

相应的条目会出现在列表中。

![local_variable_and_parameter.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/local_variable_and_parameter.png)

当您在对话框中取消选择某个参数时，将使用相应的局部值。

![when_param_deselected.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/when_param_deselected.png)

配置您的选项然后点击   OK  。

4. 从弹出菜单中选择适用的函数式接口。

![functional_interface.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/functional_interface.png)

5. 如果您愿意，可以更改提取变量的名称，若您不想使用列表中建议的名称。

![changing_variable_name.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/changing_variable_name.png)

6. IntelliJ IDEA 创建了可供您进一步使用的 lambda。

![composed_function.png](https://resources.jetbrains.com.cn/help/img/idea/2026.3/composed_function.png)

> **Tip:**
> 重构 [功能参数](extract-parameter.html#functional_parameter)也是可用的。

### 示例

|  之前  |  之后  |
| --- | --- |
|     ```JAVA import java.util.List;  public class PrintAction implements Runnable {     private List<String> data;      public PrintAction(List<String> data) {         this.data = data;     }      public void run() {         System.out.println("Data: " + data.toString());     } }                              ```    |     ```JAVA import java.util.List; import java.util.function.Function;  public class PrintAction implements Runnable {     private List<String> data;      public PrintAction(List<String> data) {         this.data = data;     }      public void run() {         Function<List<String>, String> presenter = (p) -> "Data: " + p.toString();         System.out.println(presenter.apply(data));     } }                              ```    |

## See also

### 参考

[提取变量对话框](extract-variable-refactoring-dialog.html)

### 过程

[Selecting text in the editor](working-with-source-code.html) [重命名重构](rename-refactorings.html) [Extract Variable in JavaScript](specific-javascript-refactorings.html#javascript_extract_variable)

