Sublime Text 4 中 file-header 插件因依赖 Python 2.6 的 string.Template 和旧 API 而失效，表现为快捷键无响应、字段为空或格式错乱；推荐用 DocBlockr 配合自定义 header.sublime-snippet 实现轻量稳定的作者/日期注释块。
Sublime Text 本身不内置「自动插入带作者/日期的注释块」功能，file-header 插件是社区常用方案，但它已停止维护，且在 Sublime Text 4 中兼容性差、配置反直觉——直接装它大概率失败或注释格式错乱。
为什么 file-header 插件在 ST4 上基本不能用
该插件依赖 Python 2.6 的 string.Template 和旧版 API，ST4 默认使用 Python 3.8+，导致：
• 调用 ctrl+alt+h 无响应或报 AttributeError: 'module' object has no attribute 'Template'
• 即使手动修复模板语法，author、last_modified 等字段常为空或静态不变
• 不支持项目级独立配置，所有设置全局生效，多人协作时容易冲突
推荐替代方案：安装 DocBlockr + 自定义 snippet
轻量、稳定、可控性强，且完全适配 ST4。核心思路是：用 DocBlockr 触发快捷键（如 /** + Enter），再通过自定义 .sublime-snippet 注入动态字段。
- 先通过 Package Control 安装
DocBlockr（注意不是DoxyDoxygen） - 打开菜单 Tools → Developer → New Snippet…，粘贴以下内容并保存为
header.sublime-snippet - 保存路径必须是：
Packages/User/header.sublime-snippet（可通过 Preferences → Browse Packages… 进入）
<snippet>
<content><![CDATA[/**
* @file ${1:$TM_FILENAME}
* @brief ${2:Description}
* @author ${3:${env:USER:-${env:USERNAME}}}
* @date ${4:$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE}
* @version $5
*/]]></content>
<tabTrigger>header</tabTrigger>
<scope>source</scope>
</snippet>之后在任意代码文件顶部输入 header + Tab，即可展开完整注释块；${env:USER} 会自动读取系统用户名，Windows 下 fallback 到 ${env:USERNAME}。
进阶：按语言自动补全不同风格注释
如果项目混用 Python/JS/Shell，单一 snippet 不够用，可为每种语言单独建 snippet，并限定 <scope>：
- Python 注释用
#开头？把<scope>改成source.python，<content>中换行符前加# - Shell 脚本需要
#!/usr/bin/env bash后立即跟注释？在 snippet 中写死该 shebang 行，再接注释块 - 避免冲突：每个 snippet 的
<tabTrigger>命名区分，比如pyheader、jsheader
注意：$CURRENT_YEAR 等变量只在 snippet 展开瞬间求值，不会像某些 IDE 那样“每次保存自动更新 @date”——这反而是好事，避免误覆盖人工修改的版本说明。
真正麻烦的不是插件装不上，而是默认行为和团队规范不一致：比如有人用 /* */，有人用 //，还有人坚持用 JSDoc 的 /** */。建议把 snippet 文件纳入 Git，写进 README，比折腾插件配置更省时间。
