# 内嵌提示

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

> **TL;DR**
> `设置 | 编辑器 | 内嵌提示`

嵌入提示 是出现在编辑器中的特殊标记，为代码提供额外信息，例如参数名称。 其他类型的提示会向您提供注解、代码作者、用法等方面的信息（取决于所使用的语言）。

在内嵌提示设置中，您可以配置希望在提示中获取的信息类型。

## C++ 提示

对于 C 和 C++ 代码，CLion 提供如下所述的提示类型，并提供 [Push-to-Hint 模式](#push-to-hint-mode)，该模式会隐藏提示，直到需要时才显示。

![C++ 的嵌入提示设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_inlayhints.png)

### 参数名称提示

参数名称提示是编辑器装饰项，会在方法调用时在对应实参旁显示参数名称。 这些提示可以帮助在函数调用和聚合初始化中梳理较长（有时是嵌套的）参数列表。

在下面的示例中，参数名称提示有助于发现 height 和 width 实参被混淆：

![参数名称提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_paramhints.png)

参数名称提示显示您正在初始化的成员名称，并帮助理清 C++17 及更高版本中的复杂聚合初始化：

![聚合初始化中的参数名称提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_paramhints_aggregate.png)

### 类型名称提示

当编译器根据周围代码自动推导类型时，类型名称提示可以提供帮助。 CLion 为 auto 变量、函数和 lambda 返回值类型、结构化绑定、依赖代码以及函数调用后提供类型名称提示。

> **Tip:**
> 如果您想快速禁用或配置提示，可以右键点击提示以打开上下文菜单。 在同一菜单中，可以转到选项页面或导航到相关声明。

#### 自动变量

此类提示适用于使用  `auto`  或  `decltype(auto)`  类型说明符的自动推导类型变量。 默认情况下，如果可从初始化表达式中清楚看出推导出的类型，提示将被隐藏，例如当初始值设定项是构造函数调用、常量或显式转换时。

![自动变量的类型名称提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_inlayhints_auto.png)

#### 结构化绑定

在 C++17 的 [结构化绑定声明](https://en.cppreference.com/w/cpp/language/structured_binding) 中，类型提示特别有用，因为无法显式指定结构化绑定的类型。

![结构化绑定的类型名称提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_inlayhints_structuredbindings.png)

### 类型转换提示

类型转换提示有助于显示隐藏的隐式转换，从而了解潜在的性能和正确性影响。

CLion 显示不同类型的类类型转换提示，包括对象复制、使用转换构造函数或聚合初始化的对象初始化，以及对转换运算符的调用。

![类型转换提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_inlayhints_typeconversion.png)

还可以为内置类型之间的标准转换启用提示，例如可能导致精度丢失或更改类型有符号性的数值类型之间的转换。

### 其他：预处理器指令提示

预处理程序指令提示可帮助快速了解条件包含（  `#ifdef` 、  `#ifndef` 、  `#if` 、  `#endif` 、  `#else`  和  `#elif` ）与宏定义的对应关系：

![预处理器指令提示](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_preprocessor_directive_hints.png)

### Push-to-Hint 模式

内联提示可能很有帮助，但另一方面，它们会占用编辑器空间，在某些情况下可能显得多余。

Push-to-Hint  模式（默认启用）可使提示保持隐藏，并且仅在需要时通过   按住  `Ctrl` 键   查看提示。

要更改提示的可见性，请使用   默认可见性   切换器，在  `设置 | 编辑器 | 内嵌提示 | C++`  中：

![内联提示可见性选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_nova_inlayhints_visibility.png)

> **Note:**
> 可用语言、上下文和提示类型的列表取决于 [安装/启用的插件](managing-plugins.html)。

## 配置嵌入提示的外观

嵌入提示的颜色和样式取自配色方案。 其大小基于编辑器字体：大多数提示会以比周围代码小一号的字体呈现，并跟随编辑器缩放级别。 默认情况下，CLion 使用为 IDE 用户接口配置的字体。

Procedure: 更改嵌入提示的颜色和样式

1. 在   设置  对话框 `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))中，进入  `编辑器｜配色方案｜语言默认值` ，然后选择   内联提示  。

2. 选择内嵌提示类型和状态，并根据需要配置字体颜色和效果。

Procedure: 对嵌入提示使用编辑器字体

1. 在   设置  对话框 ( `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))) 中，前往  `编辑器｜常规｜外观` 。

2. 请选择   嵌入提示使用编辑器字体  选项。

启用该选项后，CLion 会对嵌入提示使用  `设置 | 编辑器 | 字体`  中配置的字体。

