ForTea 技术文档

1. 安装指南

ForTea 是一款为 JetBrains ReSharper 提供的插件，用于增强 T4 (.tt) 文件的编辑功能。以下是安装步骤：

• 支持的 Visual Studio 版本：2010、2012、2013、2015、2017 和 2019。
• 必须安装 ReSharper 2019.1 版本（对于旧版本，例如 ReSharper 8.2、9.x、10.0、2016.x、2017.x、2018.x，有旧版本可用）。
• 在 ReSharper 菜单中使用扩展管理器安装 ForTea。

2. 项目使用说明

ForTea 插件提供了以下功能：

• 支持 .tt、.ttinclude 和 .t4 文件的编辑。
• 对 T4 指令和块进行语法高亮。
• 支持包含文件，包括 Visual Studio 的本地和全局包含。
• T4 指令支持和自动完成。
• 对 C# 代码的语法高亮。
• 为 C# 代码提供 ReSharper 的自动、基础和智能自动完成。
• 对 T4 文件提供文件结构窗口支持。
• 提供与 ReSharper 在 C# 代码中的所有功能，如查找用法、重构等。
• 提供 ReSharper C# 上下文操作和快速修复。
• 通过快速修复支持添加程序集和导入指令。
• 扩展选择功能。
• T4 错误高亮和快速修复。
• 支持自动更新。
• 支持 classic 模板和 runtime（预编译）模板。

注意事项：

• ForTea 目前仅作为 ReSharper 插件，不提供任何 Visual Studio 服务，因此存在一些限制。
• 语法高亮完全由 ReSharper 处理：要为标识符着色，您必须在 ReSharper 选项 > 代码检查 > 设置 中启用 颜色标识符。
• 目前还没有代码大纲支持。
• 尚未为 T4 文件编写自定义代码格式化器，但可以使用代码清理功能，ReSharper 选项中的 C# 格式化规则将自动应用。
• 目前无法覆盖这些规则，也没有针对 T4 特定元素（如开启和关闭块的放置）的规则。
• 目前不支持 Visual Basic T4 文件和自定义 T4 指令。

3. 项目 API 使用文档

目前文档中没有提供关于 ForTea API 的具体信息。如需了解详细使用方法，请参考官方文档或社区讨论。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明。用户可以通过以下步骤进行安装：

• 确保安装了支持的 Visual Studio 版本和所需的 ReSharper 版本。
• 打开 Visual Studio，进入 ReSharper 菜单。
• 选择扩展管理器，搜索 ForTea 插件。
• 安装插件，重启 Visual Studio。

以上步骤将帮助用户成功安装 ForTea 插件，并开始使用其提供的功能。