# 编辑模板变量对话框

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

> **TL;DR**
> `文件 | 设置 | 编辑器 | 代码模板 - 编辑变量`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 代码模板 - 编辑变量`  适用于 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)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

如果一个 [实时模板](using-live-templates.html)包含 [用户自定义变量](template-variables.html)，您可以使用   编辑模板变量  对话框来配置定义这些变量的表达式。

## 控件

|  项  |  描述  |
| --- | --- |
|  名称  |  在此字段中，以  `$<variable_name>$`  格式查看或编辑变量名称。  |
|  表达式  |     在此字段中，指定表达式以自动计算相应模板输入字段的值。       此表达式可能包含以下结构：        * 双引号中的字符串常量    * 在实时模板中定义的其他变量的名称    * [预定义函数](template-variables.html#predefined_functions)及其可能的参数      您可以手动输入表达式或从列表中选择预定义函数。 列表还显示了所选函数的参数数量和类型（如果有）。 可用功能按字母顺序列在 [Functions](#predefined_functions)表中。     |
|  默认值  |     在该字段中，指定默认字符串，以便在展开的模板的相应输入字段中输入该字符串，如果表达式在计算后未产生任何结果。       请注意，变量的默认值是一个可以引用其他实时模板变量的表达式。 要将默认值定义为文字，请将其括在引号中。     |
|  如果已定义则跳过  |  选中此复选框，如果当前输入字段的值已定义，则让 CLion 继续下一个输入字段。  |
|  上移 / 下移  |  使用这些按钮更改列表中变量的顺序。 表中变量的顺序决定了 CLion 在模板展开时在相应输入字段之间切换的顺序。  |

## 在实时模板变量中使用的函数

|  项  |  描述  |
| --- | --- |
|   `autoTypeForRangedForLoop()`   |  提供作用域基于  `for` 循环的类型推导变体：   ![循环迭代器的自动类型推导](https://resources.jetbrains.com/help/img/idea/2026.3/cl_livetemplate_iter_auto.png)  |
|   `blockCommentEnd()`   |     返回指示当前语言上下文中块注释结束的字符。     |
|   `blockCommentStart()`   |     返回指示当前语言环境下块注释开始的字符。     |
|   `camelCase(<String>)`   |     将字符串转换为  camelCase 。       例如，  `camelCase("my-text-file")` 、  `camelCase("my text file")`  和  `camelCase("my_text_file")`  都返回  `myTextFile` 。     |
|   `capitalize(<String>)`   |     将字符串的首字母大写。       例如，  `capitalize("name")`  返回  `名称` 。 或者您可以将其合并到  `capitalize(camelCase("my awesome class"))`  以获取  `MyAwesomeClass` 。     |
|   `capitalizeAndUnderscore(<String>)`   |     将字符串的所有字母大写，并在各部分之间插入下划线。       例如，  `capitalizeAndUnderscore("FooBar")` 、  `capitalizeAndUnderscore("foo bar")`  和  `capitalizeAndUnderscore("foo-bar")`  都返回  `FOO_BAR` 。     |
|   `className()`   |     返回当前类的名称（展开模板的位置）。 对构造函数模板很有用。       仅在   Java   上下文中可用。     |
|   `clipboard()`   |  返回系统剪贴板的内容。  |
|   `collectionElementName()`   |  移除  `_list` 和复数结尾 (s)。  |
|   `commentEnd()`   |  返回当前语言环境中表示注释结束的字符。 对于带有行注释的语言，返回值为空。  |
|   `commentStart()`   |  返回当前语言上下文中表示注释开始的字符。 对于带有行注释的语言，返回值是行注释的起始，与 [lineCommentStart()](#lineCommentStart) 相同。  |
|   `complete()`   |  在变量的位置调用 [代码补全](auto-completing-code.html)。  |
|   `completeSmart()`   |  在变量的位置调用 [智能类型补全](null)。  |
|   `concat(<String>, ...)`   |     返回所有作为参数传递给函数的字符串的拼接结果。       例如，  `concat(date()," ",user())`  返回当前系统日期和用户名，中间用空格分隔。     |
|   `date([format])`   |     返回当前系统日期。       默认情况下，没有参数时，它会以当前系统格式返回日期。 要使用不同的格式，请根据 [SimpleDateFormat](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html)规范提供参数。 例如，  `date("Y-MM-d, E, H:m")`  返回的日期格式为  `2020-02-27, Thu, 16:11` 。     |
|   `dbColumns()`   |     返回表或视图的列列表。 上下文代码模板中使用了  `dbColumns()` （例如，  `ins` ）。 您可以通过右键点击对象并选择   SQL 脚本   来访问上下文实时模板。     |
|   `dbObjectName()`   |     返回表或视图的名称。 上下文代码模板中使用了  `dbObjectName()` （例如，  `top` ）。 您可以通过右键点击对象并选择   SQL 脚本   来访问上下文实时模板。     |
|   `decapitalize(<String>)`   |     将字符串的首字母替换为相应的小写字母。       例如，  `decapitalize("Name")`  返回  `名称` 。     |
|   `enum(<String>, ...)`   |     返回模板扩展时建议的字符串列表。       例如，  `enum("Foo","Bar","Baz")`  显示了一个列表，您可以从中选择一个指定的字符串。     |
|   `escapeString(<String>)`   |     将特殊字符转义，以便结果可以在 Java 字符串中使用。       例如，它将制表符替换为  `\t` ，将换行符替换为  `\n` ，将反斜杠转义为  `\\` ，引号替换为  `\"` ，等等。     |
|   `executionContext()`   |     使用  `sel_getName(_cmd)` 函数返回当前方法的名称。     |
|   `expressionFormatCode()`   |     返回作为此函数参数传递的对象的字符串格式说明符。     |
|   `fastEnumeration()`   |     返回当前作用域中可用的集合和枚举的名称。     |
|   `fileName()`   |  返回当前文件的名称及其扩展名。  |
|   `fileNameWithoutExtension()`   |  返回当前文件的名称，但不包含其扩展名。  |
|   `filePath()`   |  返回当前文件的绝对路径。  |
|   `fileRelativePath()`   |  返回相对于当前项目的当前文件路径。 要检查某个给定文件的相对路径，右键点击并选择   复制引用  ，或按 `Ctrl+Alt+Shift+C` (Windows), `⌘ ⌥ ⇧ C` (macOS), `⌘ ⌥ ⇧ C` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ C` (macOS System Shortcuts), `Ctrl+Alt+Shift+C` (XWin), `Ctrl+Alt+Shift+C` (GNOME), `Ctrl+Alt+Shift+C` (KDE), `Ctrl+Alt+Shift+C` (Emacs), `Ctrl+Alt+Shift+C` (Sublime Text), `⌘ ⌥ ⇧ C` (Sublime Text (macOS)), `⌘ ⌥ ⇧ C` (Xcode), `Ctrl+Alt+Shift+C` (Visual Studio), `⌘ ⌥ ⇧ C` (Visual Studio (macOS)), `Ctrl+Alt+Shift+C` (ReSharper), `⌘ ⌥ ⇧ C` (ReSharper (macOS)), `Ctrl+Alt+Shift+C` (QtCreator), `⌘ ⌥ ⇧ C` (QtCreator (macOS)), `Ctrl+Alt+Shift+C` (NetBeans), `Ctrl+Alt+Shift+C` (Eclipse), `⌘ ⌥ ⇧ C` (Eclipse (macOS))。  |
|   `firstWord(<String>)`   |     返回作为参数传递的字符串的第一个单词。       例如，  `firstWord("one two three")`  返回  `one` 。     |
|   `lineCommentStart()`   |  返回指示当前语言环境中行注释开始的字符。  |
|   `lineNumber()`   |  返回当前行号。  |
|   `lowercaseAndDash(<String>)`   |  将字符串转换为小写并插入短横线作为分隔符。 例如，  `lowercaseAndDash("MyExampleName")`  和  `lowercaseAndDash("my example name")`  都返回  `my-example-name` 。  |
|   `methodName()`   |     返回模板展开的方法名称。       仅在   Java   上下文中可用。     |
|   `objectWithFunctions(sFunctionName1, sFunctionName2,...)`   |  返回包含成员函数的可见对象列表，这些函数列为参数。  |
|   `pyFunctionName()`   |  返回当前 Python 函数的名称。  |
|   `regularExpression(<String>, <Pattern>, <Replacement>)`   |     找到所有在  `Pattern`  中的  `字符串`  并用  `Replacement`  替换它们。 您可以将模式指定为正则表达式，以在字符串中查找所有匹配项。       例如，  `regularExpression(NAME, "a", "b")`  表达式将模板变量  `$NAME$`  中的任何字母 “a” 替换为字母 “b”。 您可以在模式部分使用 regexp 字符类；例如，  `regularExpression(NAME, "[a-z]", "b")`  将替换变量中的任何字母。 如果您希望模式（例如  `\d`  或  `\w` ）被视为正则表达式字符类，您必须对斜杠进行转义，以便您的模式看起来像  `"\\d"` 。     |
|   `rightSideType()`   |     声明左侧变量，其类型为右侧表达式的类型。       部分预定义模板在   迭代  组中使用  `rightSideType()` 功能，以便为原始类型和泛型类型提供单一模板。     |
|   `showParameterInfo()`   |     返回在向函数或方法添加参数时的参数详细信息。     |
|   `snakeCase(<String>)`   |  将字符串转换为  snake_case 。 例如，  `snakeCase("fooBar")`  和  `snakeCase("foo bar")`  都返回  `foo_bar` 。  |
|   `spaceSeparated(<String>)`   |  返回指定的字符串，并以空格作为分隔符。 例如，  `spaceSeparated("fooBar")`  返回  `foo Bar` ，而  `spaceSeparated("Foo_BAR")`  返回  `Foo BAR` 。  |
|   `spacesToUnderscores(<String>)`   |  将传入参数中的空格替换为下划线。 例如，  `spacesToUnderscores("foo bar BAZ")`  返回  `foo_bar_BAZ` 。  |
|   `substringBefore(<String>, <Delimeter>)`   |  返回指定分隔符之前的子字符串。 这对于移除测试文件名中的扩展名很有帮助。 例如，  `substringBefore(fileName(),".")`  如果在一个名为  `component-test.js`  的文件中使用，将返回  `component-test` 。  |
|   `suggestIndexName()`   |     返回一个建议的索引变量名称，其在迭代中使用最常见的名称：  `i` 、  `j` 、  `k` 等（第一个不在当前作用域中使用的名称）。       一些在   迭代  组中预定义的模板（  `fori` 、  `itar` 、  `ritar` ）使用  `suggestIndexName()` 函数来建议一个合适的索引变量名称。     |
|   `suggestVariableName()`   |     根据与变量命名规则相关的代码风格设置，基于变量类型及其初始化表达式建议变量名称。       例如，如果这是一个在迭代中保存元素的变量，CLion 会根据迭代容器的名称来猜测最合理的名称。 一些在   迭代   组中的预定义模板（  `itar` 、  `itco` 、  `iten` ）使用  `suggestVariableName()`  函数为迭代元素建议一个合适的变量名称。     |
|   `time([format])`   |     返回当前系统时间。       默认情况下，无参数时，它会返回当前系统格式的时间。 要使用不同的格式，请根据 [SimpleDateFormat](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html)规范提供参数。 例如，  `time("H:m z")`  返回的时间格式为  `13:10 UTC` 。     |
|   `underscoresToCamelCase(<String>)`   |  将带有下划线的字符串（如  snake_case ）转换为  camelCase 。 例如，  `underscoresToCamelCase(foo_bar_baz)`  和  `underscoresToCamelCase(FOO_BaR_baZ)`  都返回  `fooBarBaz` 。  |
|   `underscoresToSpaces(<String>)`   |  将字符串中的下划线转换为空格。 例如，  `underscoresToSpaces(foo_bar_baz)`  返回  `foo bar baz` ，而  `underscoresToSpaces(FOO_BaR_baZ)`  返回  `FOO BaR baZ` 。  |
|   `user()`   |  返回当前用户的名称。  |
|   `variableForIteration()`   |  返回作为循环中作用域表达式使用的对象的实例变量。  |
|   `variableForRangeBasedIteration()`   |  返回包含  `begin` 和  `end` 函数的对象实例变量。  |
|   `variableOfType(<String>)`   |     返回所有可能分配给作为参数传递的类型的变量。 例如, .       如果您传递一个空字符串  `""` 作为参数，函数会建议所有变量，而不考虑它们的类型。     |

## See also

### 流程

[Live templates](using-live-templates.html)

### 概念

[实时模板变量](template-variables.html)

