ReSharper 2026.2 Help

创建文件模板

文件模板 用于创建一个或多个具有预定义代码的新文件,例如类型声明、单元测试等。 文件模板没有快捷方式,它们通过描述来标识。 有关更多信息,请参阅 从模板创建文件 和 创建多文件模板。

文件模板的主体由纯文本组成,这些文本将按原样显示,并包含 参数。 其理念是将这些结合起来,以最大限度地提高调用模板时的效率。

创建新的文件模板

  1. 从主菜单中选择 ReSharper | Tools | Templates Explorer…。

  2. 在出现的 模板资源管理器窗口 中,单击 文件模板 选项卡。

  3. 如果您希望在特定的 设置层中创建模板,请在 层 列表中选择所需的层。 更多信息,请参阅 模板存储。

  4. 单击 新建模板 ThemedIcon.AddLiveTemplate.Screen.(Gray).png。 新创建的模板将在 模板编辑器 中打开。

  5. 在 注释 字段中指定模板名称。

  6. 可选地,在 默认文件名 中指定一个名称,该名称是 ReSharper 在应用模板时建议的。 您还可以勾选 文件名必须是有效的标识符 复选框,以使 ReSharper 检查在应用模板时指定的文件名是否作为 类型标识符有效。 如果您的模板创建了一个新类型的文件,并且类型名称是从提供的文件名通过 当前文件名(不含扩展名) 宏初始化的,那么此选项将非常有用。 您可以查看 预定义文件模板以了解其实现方式。

  7. 要更改模板的默认 作用域 ,请单击 可用性 超链接。 在出现的对话框中,使用复选框定义新模板可以应用的位置。 您可以展开某些作用域以指定详细信息(例如文件掩码或语言版本)。

    如果模板使用了非系统程序集中的类和方法,您可以仅在引用这些程序集的项目中使模板可用——在 全局 类别中,选择 引用 并指定程序集名称(不带 .dll 扩展名):

    ReSharper:为模板选择作用域
  8. 通过键入或粘贴所需代码来创建模板的主体。

    模板代码可以包含纯文本和 parameters。 一旦您键入了一个 parameter(以 $ 为前缀和后缀),它将在文本区域右侧的 形参 部分中可用。 按照 声明模板参数 部分中描述的方式配置所有定义的 parameters。

  9. 配置模板格式选项:

    • 选择 重新设置格式 复选框以使 ReSharper 根据您的 格式设置偏好自动重新格式化扩展的代码片段。

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

  10. 要保存模板,请在 Visual Studio 菜单中选择 文件 | 保存选定的项目 或按 Ctrl+S 。

当您 调用命令以应用文件模板时,将向您显示可用模板的列表。 我们称之为“快速访问列表”或简称为“快速列表”。 您可以编辑此列表,将您喜欢的模板添加到其中和/或重新排列它们的顺序。

编辑快速访问列表

  1. 从主菜单中选择 ReSharper | Tools | Templates Explorer…。

  2. 在出现的 模板资源管理器窗口 中,单击 文件模板 选项卡。

  3. 选择一个 作用域以查看此作用域的模板列表。

    快速访问列表中包含的模板显示在 在快速列表中 部分;所选作用域中其他可用的模板显示在 不在快速列表中 部分。

  4. 可选地,使用 模板类别缩小不在快速访问列表中的可用模板的范围。

  5. 使用拖放操作将模板添加到快速访问列表或从中移除,并/或重新排列它们的顺序。

2026年 7月 16日