ReSharper 2025.2 Help

模板编辑器

模板编辑器 有助于 创建编辑代码模板。 模板编辑器在新文档标签页中打开,您可以在模板和应用程序代码之间切换,以快速测试所创建的模板。

ReSharper 模板编辑器

模板编辑器为关键字、注释等提供了基础的代码高亮。 所有高亮颜色均可配置。

为模板编辑器配置高亮颜色

  1. 从菜单中选择 工具 | 选项 ,然后转到 环境 | 字体和颜色 页面。

  2. 显示项 列表中,找到以 ReSharper Template Editor开头的项。

  3. 使用 项目前景色 选择器为所选项目选择颜色。

模板编辑器 中的控件可以分为两个逻辑组,这两个组分别描述在以下两张表格中:

模板选项

条目

描述

快捷方式

可用于动态模板。

可以在源代码中键入以 调用动态模板的快捷键(缩写)。

描述

对于环绕模板和文件模板,这是在您尝试选择和应用模板时显示在下拉列表中的标识符。 对于动态模板,这是一个可选的描述字符串,与模板快捷键一起在 自动完成列表中弹出。

默认文件名

可用于文件模板。

当您 应用文件模板时,ReSharper 提示的默认名称。

文件名必须是有效的标识符

可用于文件模板。

此复选框使 ReSharper 检查在应用模板时指定的文件名是否作为 类型标识符有效。 如果您的模板为新类型创建文件,并且类型名称由 当前文件名(无扩展名) macro初始化,那么此选项非常有用。 您可以查看 预定义的文件模板以了解它的实现方式。

缩短限定引用

此复选框使 ReSharper 自动插入命名空间导入指令或移除模板应用后变得多余的限定符。 如果未选中此复选框,ReSharper 将不会插入任何命名空间导入指令。

重新设置格式

此复选框使 ReSharper 根据您的 格式首选项自动重新格式化展开的代码片段。

可用性

此超链接显示并允许修改模板的 范围

添加新文件

可用于文件模板。

此按钮向 多文件模板添加一个新的空文件。

从现有模板添加文件

可用于文件模板。

此按钮通过引用现有文件模板向 多文件模板添加新文件。

模板参数

条目

描述

参数名称

模板参数的名称,它们在模板正文中定义。

选择宏[宏的名称]

此超链接显示或允许选择计算参数值的 。 通过单击此超链接,您可以在 选择宏 对话框中选择一个宏。 如果所选宏具有宏参数,则在对话框中以加粗显示(例如, formattype)。 在这种情况下,选择宏后,模板 形参 下会出现一个文本字段或选择器。 您可以在那里指定宏参数。

可编辑 或可编辑的发生选择器

这些控件使您可以通过以下方式之一使参数 可编辑

  • 如果 形参 在模板中仅使用一次,请确保选中复选框。

  • 如果 形参 在模板中使用多次,将出现一个组合框,您可以在其中选择可编辑出现的顺序号。 此编号指定当模板通过 热点会话 部署时,输入焦点将设置到 形参 的哪个出现位置。 您可能还会注意到这些编号以“M”或其他字母为前缀。 这些字母定义了在 多文件模板的哪个文件中应为此 形参 设置输入焦点。 “M”代表主文件,并出现在所有模板中。

上移/下移

如果您选择一个参数,可以使用这些按钮更改参数的顺序。 形参 列表中的位置定义了在应用模板时热区会话期间切换 形参 的顺序。 这仅影响可编辑的 形参。

最后修改日期: 2025年 9月 27日