# TODO 注释

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

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

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

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

默认情况下，CLion 会识别两种模式：  `TODO`  和  `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | TODO` 。

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

![多行 TODO 注释](https://resources.jetbrains.com/help/img/idea/2026.3/cl_multiline_todo.animated.gif)

您可以在   TODO   工具窗口（  `查看 | 工具窗口 | TODO` ）中查看所有可用的 TODO 项。 要跳转到源代码中相关注释的位置，请双击   TODO   工具窗口中的相应 TODO 项。 要在每次选择相应的 TODO 项时自动跳转到相关注释的位置，请右键点击   TODO   工具窗口标题，指向   查看选项  ，然后选择   单击导航  （此选项默认启用）。

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

您可以添加自己的模式，并筛选列表以仅显示符合特定模式的 TODO 项目。 例如，您可以选择使用  `OPTIMIZE` 模式在代码中标记可能的优化点，并在   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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))中，选择  `编辑器 | TODO` 。

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

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

```PLAINTEXT
\boptimize\b.*

```

这匹配单词“optimize”(  `\b`  表示单词边界)并允许注释中任意数量的其他字符。

然后点击   确定  保存新模式。

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

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

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

4. 点击   确定   以在   TODO   设置对话框中应用更改。

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

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

## See also

### 相关内容

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

