# 引入

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

CLion 提供以下重构：

* [引入字段](#intro_field)，

* [引入命名空间别名](#namespace_alias)，

* 以及 [引入 using enum](#using_enum)。

## 引入字段

此重构基于选定的表达式创建一个新字段，用该表达式或构造函数对其进行初始化，并用新引入的字段的引用替换表达式的出现。

要调用此重构，请按 `Ctrl+Alt+F` (Windows), `⌘ ⌥ F` (macOS), `⌘ ⌥ F` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ F` (macOS System Shortcuts), `Ctrl+Alt+F` (XWin), `Ctrl+Alt+F` (GNOME), `Ctrl+Alt+F` (KDE), `Ctrl+Alt+F` (Emacs), `Ctrl+Alt+F` (Sublime Text), `Ctrl+Alt+F` (Sublime Text (macOS)), `⌘ ⌃ ⌥ F` (Xcode), `Ctrl+R, F` (Visual Studio), `⌘ R, F` (Visual Studio (macOS)), `Ctrl+Alt+D` (ReSharper), `⌘ ⌥ D` (ReSharper (macOS)), `Ctrl+Alt+F` (QtCreator), `⌘ ⌥ F` (QtCreator (macOS)), `Alt+Shift+E` (NetBeans), `Ctrl+Alt+F` (Eclipse), `⌘ ⌥ F` (Eclipse (macOS))。

在下面的示例中，我们使用此重构将两个相同字符串的出现替换为一个新的私有字段，并从现有构造函数中对其进行初始化：

重构前:

```CPLUSPLUS
                
#include <exception>
#include <fstream>
#include <iostream>
#include <string>

class ErrorHandler {
public:

    ErrorHandler() {}

    void logError(const std::exception& e) {
        std::ofstream errorLog{"log.txt"};
        errorLog << "Something has failed: " << e.what() << '\n';
    }

    void printError(const std::exception& e) {
        std::cerr << "Something has failed: " << e.what() << '\n';
    }

};

            
```

重构后:

```CPLUSPLUS
                
#include <exception>
#include <fstream>
#include <iostream>
#include <string>

class ErrorHandler {
public:

    ErrorHandler(): error_message("Something has failed: ") {}

    void logError(const std::exception& e) {
        std::ofstream errorLog{"log.txt"};
        errorLog << error_message << e.what() << '\n';
    }

    void printError(const std::exception& e) {
        std::cerr << error_message << e.what() << '\n';
    }

private:
    std::string error_message;

};


```

## 引入命名空间别名

此重构帮助您为命名空间的使用创建一个命名空间别名，并用该别名替换当前选定的使用或当前文件中的所有使用。 根据选定的用法，命名空间别名会在尽可能接近用法的作用域内声明。

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)), `⌘ ⌃ ⌥ T` (Xcode), `Ctrl+Shift+R` (Visual Studio), `⌘ ⇧ R` (Visual Studio (macOS)), `Ctrl+Shift+R` (ReSharper), `⌘ ⇧ R` (ReSharper (macOS)), `Ctrl+Alt+Shift+T` (QtCreator), `⌃ T` (QtCreator (macOS)), `Ctrl+Alt+Shift+T` (NetBeans), `Ctrl+Alt+Shift+T` (Eclipse), `⌃ T` (Eclipse (macOS))，然后在“重构此”弹出窗口中选择   引入命名空间别名  。

如果文档中存在命名空间使用的多个出现，您可以选择替换当前使用或所有使用。

在下面的示例中，我们使用此重构为  `SpaceOne::SpaceTwo` 命名空间添加一个命名空间别名。

重构前:

```CPLUSPLUS
                
namespace SpaceOne
{
  namespace SpaceTwo
  {
    int ten = 10;
    inline void foo()
    {
      // do something
    }
  }
}

inline int test()
{
  SpaceOne::SpaceTwo::foo();
  return SpaceOne::SpaceTwo::ten;
}

            
```

重构后:

```CPLUSPLUS
                
namespace SpaceOne
{
  namespace SpaceTwo
  {
    int ten = 10;
    inline void foo()
    {
      // do something
    }
  }
}

inline int test()
{
  namespace s_two_alias = SpaceOne::SpaceTwo;
  s_two_alias::foo();
  return s_two_alias::ten;
}

            
```

## 引入使用枚举

C++20  `using enum` 语法允许您从目标枚举中添加所有枚举器。 因此，使用其成员枚举器时，您可以省略枚举名称的重复。

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)), `⌘ ⌃ ⌥ T` (Xcode), `Ctrl+Shift+R` (Visual Studio), `⌘ ⇧ R` (Visual Studio (macOS)), `Ctrl+Shift+R` (ReSharper), `⌘ ⇧ R` (ReSharper (macOS)), `Ctrl+Alt+Shift+T` (QtCreator), `⌃ T` (QtCreator (macOS)), `Ctrl+Alt+Shift+T` (NetBeans), `Ctrl+Alt+Shift+T` (Eclipse), `⌃ T` (Eclipse (macOS))，然后在“重构此”弹出窗口中选择   引入使用枚举  。

CLion 还会检测可应用  `using enum`  的代码片段，并在 `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)) 菜单中建议此重构：

![引入使用枚举意图操作](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_introduceusingenum_intention.png)

如果文档中存在枚举使用的多个出现，请选择替换当前使用或所有使用：

![引入使用枚举的多个出现](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_introduceusingenum_multiple.png)

2. CLion 就地执行重构：

![引入使用枚举结果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_introduceusingenum_result.png)

## See also

### 操作指南

[转换为作用域枚举](convert-to-scoped-enum.html) [重构](refactoring-source-code.html)

