待办事项列表

ReSharper 提供了一种简单的方法来跟踪任务和代码中的技术债务——匹配特定模式的代码项（注释、字符串字面量或标识符）可以在编辑器中以及整个解决方案中通过待办事项资源管理器窗口轻松定位。

待办事项项目会根据其类型（编辑、普通、问题、警告、错误）在编辑器和标记栏上高亮显示。颜色可以在 Visual Studio 选项的环境 | 字体和颜色页面上进行配置：

TODO 模式

默认情况下，ReSharper 提供了三种预定义模式，用于常用的待办事项项目，类型如下：

注释中包含 待办事项 或 待办事项：some description 的行（不区分大小写） - 普通
注释中包含 错误： 的行（区分大小写） - 错误
代码中的 NotImplementedException - 编辑

您还可以定义自己的模式，以便能够快速访问待办事项资源管理器窗口中的特定技术债务项目。

定义自定义待办事项模式

打开 ReSharper 选项的工具 | 待办事项资源管理器页面 Alt+R, O。
单击工具栏上的添加。
为您的待办事项模式提供一个标题，并指定一个包含您希望在注释中检测到的关键字的正则表达式。例如， (\W|^)(?<TAG>重构)(\W|$)(.*)。
选择 ReSharper 应应用表达式以查找待办事项项目的位置（注释、字符串和/或标识符）。
可选地，指定模式是否区分大小写。
选择模式的类型，以定义匹配的项目在编辑器和待办事项资源管理器窗口中的颜色显示方式。
单击确定将此模式添加到列表中。
您还可以复制、编辑或删除现有模式。
单击选项对话框中的保存应用修改，让 ReSharper 选择保存位置，或者通过从保存到选择器中选择特定的设置层来保存修改。有关更多信息，请参见管理和共享 resharper 设置。

注释中的多行待办事项

默认情况下，如果后续行相对于第一行至少缩进一个空格，注释中的待办事项项目可以是多行的：

            
// TODO: beginning of the comment,
//  comment continued on the next line

如果您只希望注释中的待办事项项目为单行，可以在 ReSharper 选项的将以下行的缩进文本视为同一待办事项的一部分页面工具 | 待办事项资源管理器Alt+R, O 上清除该选项。

启用注释中的多行待办事项项目后，您可以选择按原样显示多行项目，或将整个多行项目显示为单行。为此，请使用待办事项资源管理器工具栏上的启用多行显示按钮：

将待办事项链接到外部 URL

在待办事项模式中，您可以为指向外部 URL 的项目添加占位符。这对于问题跟踪器特别有用 — 您可以在注释中使用问题的 ID，ReSharper 将允许您在浏览器或直接在编辑器预览视图中打开相应的问题。

假设您的项目在 GitHub 上，您希望在代码中为 GitHub 问题添加注释。您只需创建一个自定义待办事项模式即可：

正则表达式： (?<=\W|^)(?<TAG>GH \#(?<ISSUE_ID>\d+))(\W|$)(.*)
URL： https://github.com/<YOUR_PROJECT>/issues/${ISSUE_ID}

ReSharper 现在会将注释中的 GH ＃XX 视为指向相应 GitHub 问题的链接。

除了单击这些注释上的 Ctrl ，您还可以单击 Ctrl+Shift 在编辑器预览视图中打开链接。导航到 URL 的两种方式也可以通过 Alt+Enter 菜单使用。

在待办事项之间导航

要在当前文件中导航待办事项项目，请使用标记栏上的待办事项标记。

研究整个解决方案中的待办事项

按 Control+Alt+. 或从主菜单中选择 ReSharper | 窗口| 待办事项资源管理器。或者，您可以按 Control+Shift+A ，在弹出窗口中开始输入命令名称，然后在那里选择它。
在打开的待办事项资源管理器窗口中，单击或以导航到下一个或上一个项目。
要在编辑器中定位待办事项项目，请双击它们。
要在窗口中直接研究所选项目的源代码，请单击工具栏上的显示预览。如有必要，您可以将预览窗格定位在底部或右侧。

分组和筛选待办事项

默认情况下，待办事项资源管理器根据项目结构列出待办事项。如有必要，您可以使用分组依据选择器更改分组选项。您可以禁用分组，按标签、类型、命名空间、目录、项目分组。

根据代码库的大小和年龄，可能会有很多待办事项项目。要专注于特定项目，您可以通过模式筛选待办事项项目（例如， 待办事项 或 错误） — 只需在筛选器选择器中选择所需的模式以显示匹配相应模式的项目并隐藏所有其他项目。

待办事项资源管理器窗口工具栏控件

控件	名称	描述
	全部展开/全部收起	展开/折叠当前选项卡中的所有节点。
	上一个/下一步 `Shift+F8`/`F8`	导航到上一个/下一个项目，并相应地滚动浏览源代码。
	显示预览`Ctrl+P`	隐藏或显示预览选定项目的窗格，位置由列表指定（在窗口底部或右侧）。
	导出	单击此按钮以文本格式导出当前显示在窗口中的数据，或使用下拉选择器以 XML 或 HTML 格式导出数据。出现的导出数据对话框将帮助您将数据保存到文件或复制到剪贴板。
	待办事项设置	打开 ReSharper 选项的工具 \| 待办事项项目页面，您可以在其中管理待办事项项目的模式。
	绘制条目	切换窗口中待办事项项目的颜色显示方式，根据其类型（编辑、普通、问题、警告、错误）。颜色可以在 Visual Studio 选项的环境 \| 字体和颜色页面上进行配置：
	启用多行显示	当注释中的多行待办事项项目启用时，您可以使用此按钮选择按原样显示多行项目，或将整个多行项目显示为单行。
	在生成的代码中显示待办事项项目	允许您显示或隐藏生成代码中的待办事项项目。您可以在 ReSharper 选项的代码检查 \| 生成的代码页面上配置包含生成代码的文件和区域列表。
	筛选器	使用此列表选择一个筛选器，仅显示与相应模式相关的项目。默认情况下，提供了五个筛选器：（全部）待办事项注释错误未实现
	分组依据	使用此列表选择分组待办事项项目的标准。提供了几种选项：无 - 项目显示为一个简单列表。类型 - 项目按包含的类型分组。命名空间 - 项目按命名空间分组，显示为一个简单列表，不考虑嵌套结构。命名空间和类型 - 项目按命名空间分组，并在更低级别按其遇到的类分组。目录 - 项目按存储它们的目录分组；目录显示为一个简单列表，不考虑嵌套结构。文件 - 项目按包含它们的文件分组。目录和文件 - 项目按存储它们的目录分组，并在更低级别按包含它们的文件分组；目录显示为一个简单列表，不考虑嵌套结构。项目 - 项目按包含它们的项目分组。项目和类型 - 项目按包含的项目分组，并在更低级别按类型分组。项目和目录 - 项目按包含的项目分组，并在更低级别按目录分组；在项目内，目录显示为一个简单列表，不考虑嵌套结构。项目结构 - 项目按项目的物理结构分组，表示所有嵌套关系。