<p>PyCharm的TODO提示“烦人”是因为默认高亮并汇总所有# TODO/# FIXME注释,造成视觉干扰和提交弹窗;可通过清空Editor→TODO中的Patterns彻底禁用,或自定义正则与过滤器精准管控。</p>

为什么TODO提示会“烦人”
PyCharm默认把所有 # TODO、# FIXME 注释都高亮并汇总到下方 TODO 工具窗口(Alt+6),但实际开发中,很多是临时标记、测试残留或他人遗留的模糊注释,既不打算处理,又持续干扰视觉——比如整行变黄底、侧边栏小图标闪烁、甚至 commit 前弹窗提醒。
关闭TODO高亮和自动检测(最直接)
这不是隐藏,而是彻底停用 PyCharm 对 TODO 类注释的识别逻辑:
- 打开
Settings(Windows/Linux:Ctrl+Alt+S;macOS:Cmd+,) - 进入
Editor → TODO - 清空所有
Patterns列表里的正则表达式(如\bTODO\b、\bFIXME\b)——留空即禁用全部匹配 - 取消勾选
Enable TODO tool window(如果还希望保留窗口但不显示内容,这步可跳过)
改完后,# TODO 就只是普通注释,不再高亮、不进工具窗口、不参与搜索(Find Usages 也不再关联)。
只屏蔽特定TODO,保留有用的
如果你只想过滤掉低价值注释(比如自动生成的、无责任人、超期未处理的),别关死,改规则更稳妥:
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 在
Settings → Editor → TODO的Patterns区域,点击+新增一行 - 输入正则:
\bTODO\s*:\s*.*?(匹配带冒号的 TODO,通常更规范) - 给它单独配色(比如浅灰),再把默认的
\bTODO\b模式颜色调成透明或禁用 - 配合
Filters(在TODO窗口右上角齿轮图标里),建一个只显示含@owner或2026年份的过滤器
这样,只有按你团队规范写的 # TODO @alice: 加缓存 才会进 TODO 窗口,其他一律无视。
Commit前不再弹窗提醒
那个“有 TODO 未处理,确定提交?”的弹窗,来自 VCS 提交检查,和 TODO 高亮无关:
- 进
Settings → Version Control → Commit Dialog - 取消勾选
Warn if TODOs are found in the files to be committed
注意:这个选项只影响 commit 弹窗,不影响编辑器内高亮或 TODO 窗口。如果已关掉 Patterns,这步其实多余;但如果保留了 TODO 检测,就一定要关它,否则每次点 Commit 都要多点一次“强制提交”。
真正容易被忽略的是:Patterns 清空后,旧的 TODO 条目不会自动从 TODO 窗口消失,得手动刷新(点窗口右上角循环箭头)或重启 PyCharm 才彻底清空缓存。

















