# TODO 注释

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> 默认模式：  `待办事项`  和  `FIXME`
>
>
>
> 配置：  `设置 | 编辑器 | TODO`
>
>
>
> 工具窗口：  `查看 | 工具窗口 | TODO`

有时，需要标记代码的某些部分以供日后参考：可优化和改进的区域、可能的更改、需要讨论的问题，等等。 IntelliJ IDEA 允许添加在编辑器中 [高亮显示](settings-colors-and-fonts.html)、在项目分析时编入索引，并在   待办事项  工具窗口中列出的特殊类型注释。 这样您和您的团队成员可以跟踪需要关注的问题。

![TODO 注释示例](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_todo_comments_example.png)

1.  单行 TODO 注释

2.  多行 TODO 注释

3.  常规注释行

4.    待办事项   工具窗口

5.  待办事项

默认情况下，IntelliJ IDEA 会识别两种模式：  `待办事项`  和  `FIXME` ，不区分大小写。 这些模式可以在任何受支持文件类型的行注释和块注释中使用。 您可以修改默认模式或 [添加您自己的模式](#add_pattern_filter_todo)，如果必要的话。

使用所用语言的标准注释样式编写 TODO。 在 Markdown 中，您可以 [模拟注释](markdown.html#comments)。

Procedure: 创建一个多行 TODO 项目

* 将注释行之后的文本缩进。

您可以使用空格和制表符，或者两者混用来缩进多行 TODO 项目。

Procedure: 禁用多行 TODO 项目

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | TODO` 。

2. 清除   将后续行中缩进的文本视为同一 TODO 的一部分   复选框。

Procedure: 查看 TODO 项目

* 打开   待办事项   工具窗口：  `查看 | 工具窗口 | TODO` 。

请使用选项卡来更改您想查看的待办事项来源：从当前项目中的所有文件、当前文件中的文件、基于特定文件 [范围](configuring-scopes-and-file-colors.html)的文件，或来自 [活动变更列表](managing-changelists.html)的文件（如果您配置了 [版本控制集成](enabling-version-control.html)）。

要跳转到源代码中的 TODO 注释，请点击   待办事项   工具窗口中的相应 TODO 项目。 要禁用此行为，请使用工具栏上的   单击导航  按钮 ![点击导航按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.autoscrollToSource.svg)（在这种情况下，您需要双击 TODO 项目以跳转到相关评论）。

Procedure: 添加自定义模式并筛选 TODO 项目

您可以添加自己的模式，并筛选列表以仅显示符合特定模式的 TODO 项目。 例如，您可以选择使用  `优化` 模式在代码中标记可能的优化点，并在   待办事项  工具窗口中查看时忽略所有其他类型的TODO项。

1. 在   设置  对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中，选择  `编辑器 | TODO` 。

2. 使用 [正则表达式](regular-expressions.html)指定自定义模式。

例如，要在评论中为单词  `优化`  添加模式，请点击 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)，在   模式   部分的   待办事项   对话框中，输入以下正则表达式：

```PLAINTEXT
\boptimize\b.*

```

这会匹配单词 "optimize"（  `\b`  表示单词边界），并允许注释中包含任意数量的其他字符。

然后点击   OK  保存新模式。

3. 添加一个过滤器来分组 TODO 模式并在   待办事项  工具窗口中单独查看相应的 TODO 项目。

例如，要在  `优化` 筛选器中添加新模式，请在 !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)对话框的   筛选器  部分中点击   待办事项  ，指定  `优化` 作为其名称，并选择要包含在此筛选器中的新模式。

然后点击   OK  以保存新过滤器。

![TODO 设置对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_TODOsettings_add_filter.png)

4. 点击   OK   以在   待办事项   设置对话框中应用更改。

5. 要应用新过滤器，请在   待办事项   工具窗口中，点击 ![筛选 TODO 项目按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.filter.svg) 并选择  `优化`  过滤器。

您为模式选择的图标将显示在   待办事项   工具窗口中，以更好地区分各类 TODO 项目。 通过启用   区分大小写  复选框，您可以强制模式仅与指定的大小写匹配。

## See also

### 相关

[颜色与字体](configuring-colors-and-fonts.html) [配色方案](settings-colors-and-fonts.html) [字体设置](settings-editor-font.html)

