将任务列表与代码注释和快捷方式配合使用

利用 Visual Studio 中的任务列表工具,可跟踪使用令牌(如 TODOHACK 自定义令牌)的代码注释。 还可以使用此功能来管理直接转到代码中预定义位置的任务快捷方式。 默认情况下,任务列表将在 Visual Studio 交互式开发环境 (IDE) 的应用程序窗口底部打开:

Visual Studio 中应用程序窗口底部“任务列表”窗口的屏幕截图。

如果未看到“任务列表”窗口,请选择查看>任务列表,或使用键盘快捷键 Ctrl+\T。 与 Visual Studio IDE 中的其他功能窗口一样,可以将“任务列表”窗口移到 IDE 图面上的任意位置。

使用预定义令牌

Visual Studio 通过扫描代码以获取注释标记和令牌来准备任务列表内容。 多个预定义令牌可用于 C/C++、C# 和 Visual Basic 程序:HACKTODOUNDONEUnresolvedMergeConflict。 这些标记标签不区分大小写。

Visual Studio 在包含三个组件时会识别注释:

  • 注释标记,例如 //#<!--

  • 注释令牌前缀,例如 TODOhackMoveToHeader

  • 标记后面的注释文本

下面是 C# 中的代码注释示例:

// TODO: Load state from previously suspended application

当 Visual Studio 识别预定义令牌时,它会在“任务列表”中将注释文本显示为任务。

创建自定义令牌

可以执行以下步骤为任何编程语言创建自定义令牌:

  1. 在 Visual Studio 的“工具”菜单上,选择“选项”。

  2. 展开“环境”部分,然后选择“任务列表”选项卡。此时会打开“任务列表选项”页面:

    显示如何在 Visual Studio 中为任务列表添加令牌(包括预定义令牌和自定义令牌)的屏幕截图。

  3. 在“名称”文本框中,输入自定义令牌的名称,例如“优化”。

  4. 展开“优先级”下拉列表,并选择自定义令牌的默认优先级。

  5. 若要将自定义令牌添加到令牌列表,请选择“添加”。

  6. 要应用更改,请选择确定

当 Visual Studio 识别自定义令牌时,它会在“任务列表”中将注释文本显示为任务。

添加代码任务快捷方式

代码任务快捷方式是在 Visual Studio 在任务列表中跟踪的代码中添加的书签。 这种类型的快捷方式具有与常规书签不同的图标。

  1. 若要创建代码任务快捷方式,请将指针插入到代码中你想要放置快捷方式的位置。

  2. 选择编辑>书签>添加任务列表快捷方式,或使用键盘快捷键 Ctrl+KCtrl+H

    显示如何在任务列表中添加书签以创建代码任务快捷方式的屏幕截图。

使用任务和快捷方式访问代码

Visual Studio 使用代码注释令牌实例和代码任务快捷方式更新任务列表后,可以使用这些项快速转到代码中的链接位置:

  1. 若要转到任何任务的代码中的位置,请双击任务列表中的任务项。

  2. 若要跳转到列表中的上一个或下一个任务的代码位置,请右键单击列表中的当前任务,然后选择“下一任务”或“上一任务”。 Visual Studio 的“视图”菜单上也提供了这些操作。

列表项排序

可以更改列表项的排序顺序:

  1. 若要更改列表的主要排序顺序,请选择列标头。 Visual Studio 根据所选列中的项进行列表内容排序。

  2. 若要应用次要排序顺序,请选择 Shift 和不同的列标头。 Visual Studio 按第一个选定列后跟第二个选定列进行列表内容排序。

可以继续此方法,并通过选择 Shift 和其他列标头来应用更精细的排序。

列显示、隐藏和排序

还可以处理列表中的特定列:

  1. 若要显示列,请右键单击列表中的任意位置,然后选择“显示列”。 在浮出控件菜单上,选择要显示的列。 以下列可用:“优先级”、“说明”、“项目”、“项目级别”、“路径”、“文件”、“行”和“列”。

    • 在浮出控件菜单上,Visual Studio 会在可见列旁边显示复选标记。

    • 若要隐藏列,请取消选择浮出控件菜单上的列名。 Visual Studio 会删除复选标记。

  2. 若要更改列表中的列顺序,请将列标头拖到所需位置。

提示

“项目级别”列表示项目依赖关系。 级别为 1 的项目不依赖于任何其他项目。 级别为 2 的项目依赖于级别为 1 的一个或多个项目,依此类推。 有关详细信息,请参阅标准表列定义:“项目级别”字段

  • 查看“任务列表、环境和选项”对话框的参考