pycharm的todo标签是可跳转、过滤和自动索引的任务管理入口,需用# todo:或# fixme:格式(冒号+空格),支持自定义正则标签、快捷键alt+6/cmd+6打开、live templates批量插入带时间戳条目,并需定期清理避免堆积。

PyCharm 的 TODO 标签不是装饰,是可跳转、可过滤、可自动索引的任务管理入口——只要注释格式对,它就能立刻出现在 TODO 工具窗口里,点一下就跳转到代码行。
怎么写才能被 PyCharm 识别为 TODO
PyCharm 默认只识别两种基础模式:# TODO: 和 # FIXME:(注意冒号和空格)。大小写不敏感,但必须紧贴 # 后面,中间不能有其他字符。
- ✅ 正确:
# TODO: 实现用户登录校验、# fixme: 处理空列表异常 - ❌ 无效:
#TODO(缺冒号)、# todo - 优化性能(用短横线代替冒号)、# TODO:(前面有空格,部分旧版本可能不识别) - ⚠️ 注意:如果项目里用了
# HACK或# NOTE,默认不会出现在TODO窗口中,需手动添加正则匹配模式
怎么快速打开和筛选 TODO 列表
默认快捷键是 Alt+6(Windows/Linux)或 Cmd+6(macOS),点击后底部弹出 TODO 工具窗口。它不是静态列表,而是实时扫描整个项目源码的结果。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 双击任意条目,直接跳转到对应代码行
- 右键条目 →
Jump to Source(等效于按F4) - 点击窗口右上角的
Filter图标,可启用/禁用已有过滤器;比如只看FIXME,或排除测试文件夹下的 TODO - 过滤器本质是正则表达式,例如
\bFIXME\b匹配独立单词 FIXME,src/.*\.py可限定路径范围
怎么自定义自己的任务标签(比如 REVIEW、OPTIMIZE)
进入 File > Settings > Editor > TODO(macOS 是 PyCharm > Preferences),在 Patterns 区域点绿色 + 添加新规则。
- Pattern 填正则,例如
\bREVIEW\b.*—— 注意要加.*匹配后续文字,否则只高亮单词本身 - 可单独设置图标颜色,让
REVIEW和TODO在列表里视觉区分开 - 新增后,PyCharm 会自动重新扫描整个项目,无需重启
- ⚠️ 容易踩坑:正则写错会导致整行不匹配,建议先在在线正则工具(如 regex101)验证;另外,PyCharm 不支持 Perl 风格的
(?i)忽略大小写标志,得写成[rR][eE][vV][iI][eE][wW]或直接勾选 “Case insensitive” 选项
怎么批量插入带时间戳和作者的 TODO
靠手敲 # TODO 2026-07-31 @zhangsan: 效率低还容易错。用 Live Templates 一键生成更可靠。
- 进
Settings > Editor > Live Templates,选Other组,点+→Live Template - Abbreviation 填
td(或其他你喜欢的缩写) - Template text 填:
# TODO $DATE$ @$USER$: $END$ - 点
Edit variables,给DATE设表达式date("yyyy-MM-dd"),USER设为user() - 应用后,在编辑器里输入
td再按Tab,就会自动展开成带日期和当前系统用户名的 TODO 行 - ⚠️ 注意:
$END$是光标最终停留位置,方便你紧接着输入具体内容;别漏掉,否则光标会卡在冒号后面
真正难的不是加标签,而是定期清理——没人维护的 TODO 会越积越多,最后变成“已知不可修复”的噪音。建议把 TODO 窗口固定在开发界面一侧,每天开工前扫一眼,做完就删,别让它活过三天。










