# 实时模板

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

> **TL;DR**
> 插入动态模板： `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))
>
>
>
> 展开实时模板： `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+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))   设置 | Editor | 实时模板

请使用  实时模板 将常见的代码结构插入到您的代码中，如循环、条件、声明或打印语句。

要展开代码片段，请输入相应的模板缩写并按 `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))。 . 继续按 `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))以从模板中的一个 [变量](template-variables.html)跳转到下一个。 按 `Shift+Tab` (Windows), `⇧ ⇥` (macOS), `⇧ ⇥` (IntelliJ IDEA Classic (macOS)), `⇧ ⇥` (macOS System Shortcuts), `Shift+Tab` (XWin), `Shift+Tab` (GNOME), `Shift+Tab` (KDE), `Shift+Tab` (Emacs), `Ctrl+[` (Sublime Text), `⌘ [` (Sublime Text (macOS)), `⌘ [` (Xcode), `Shift+Tab` (Visual Studio), `⇧ ⇥` (Visual Studio (macOS)), `Shift+Tab` (ReSharper), `⇧ ⇥` (ReSharper (macOS)), `Shift+Tab` (QtCreator), `⇧ ⇥` (QtCreator (macOS)), `Alt+Shift+Left` (NetBeans), `Shift+Tab` (Eclipse), `⇧ ⇥` (Eclipse (macOS))返回到上一个变量。

|  调整前  |  调整后  |
| --- | --- |
|    ![可用实时模板列表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qsg_livetemplates_before.png)  |    ![插入 live template 的结果](https://resources.jetbrains.com/help/img/idea/2026.3/cl_qsg_livetemplates_after.png)  |

## 活模板的类型

可以区分以下几种类型的实时模板：

* 简单模板 只包含固定的纯文本。 当您展开一个简单模板时，文本会自动插入到源代码中，替换缩写。

* 参数化模板 包含允许用户输入的 [变量](template-variables.html)。 当您展开一个参数化模板时，变量要么被替换为供用户手动指定的输入字段，要么由 CLion 自动计算。

* Surround templates 用用户指定的文本包装所选代码块。 例如， `T` 会扩展成一对标签，您可以为其指定一个名称。 您还可以选择一段代码，然后按 `Ctrl+Alt+J` (Windows), `⌘ ⌥ J` (macOS), `⌘ ⌥ J` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ J` (macOS System Shortcuts), `Ctrl+Alt+J` (XWin), `Ctrl+Alt+J` (GNOME), `Ctrl+Alt+J` (KDE), `Ctrl+Alt+J` (Emacs), `Ctrl+Alt+J` (Sublime Text), `⌘ ⌥ J` (Sublime Text (macOS)), `⌘ ⌥ J` (Xcode), `Ctrl+E, U` (Visual Studio), `⌘ E, U` (Visual Studio (macOS)), `Ctrl+Alt+J` (ReSharper), `⌘ ⌥ J` (ReSharper (macOS)), `Ctrl+Alt+J` (QtCreator), `⌘ ⌥ J` (QtCreator (macOS)), `Ctrl+Alt+J` (NetBeans), `Ctrl+Alt+J` (Eclipse), `⌘ ⌥ J` (Eclipse (macOS)) 打开 选择模板 弹出窗口，并选择 `T` 模板将所选内容用一对标签包装起来。

[后缀代码补全](postfix-code-completion.html) 类似于实时模板。 它会在不选择当前表达式的情况下对其进行转换。 例如，您可以在表达式后输入  `.if` ，以调用相应的后缀完成，并用  `if` 语句包装表达式。

## 配置实时模板

要配置实时模板，请打开   编辑器 | 实时模板   设置页面 `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)) 。 在   活动模板  页面，您可以查看所有可用的实时模板，使用复选框启用和禁用它们，编辑现有模板，并 [创建新的模板](creating-and-editing-live-templates.html)。

![活模板设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_livetemplate_settings.png)

模板根据使用环境（通常是相应的语言）进行分组。 要将模板移动到其他分组，请右键点击模板，选择   移动  ，然后选择所需分组名称。

每个实时模板由包含字母数字字符、点和连字符的缩写定义。 缩写在一个组内必须唯一，但相同的缩写可以在不同的组中使用，并根据相应组的上下文扩展为不同的结构。 修改后的默认模板缩写以蓝色字体显示在列表中。

仅在此对话框中启用的模板会显示在编辑器中。 如果模板处于激活状态，编辑器对其缩写是敏感的。 否则，该缩写被视为一组字符。

在   模板文本  字段中，您可以输入可能包含纯文本和变量的模板正文，格式为  `$<variable name>$` 。 如果必要，请点击   编辑变量   并根据需要 [配置变量](null)。 要在模板文本中转义美元符号  `$` ，只需将其重复  `$$` 。

> **Tip:**
> 只有当模板主体包含至少一个用户定义的变量，即不同于  `$END$`  或  `$SELECTION$`  的变量时，   编辑变量   按钮才会启用。

有关更多信息，请参阅 [创建实时模板](creating-and-editing-live-templates.html)。

Procedure: 将修改后的模板恢复为默认设置

* 在   设置  对话框的 Editor | Live Templates 页面上，右键点击您想要恢复的模板，然后点击   恢复默认值  。

