Sublime Text需插件实现自动添加作者信息：FileHeader插件需配置Settings-User变量、语言模板占位符及正确文件后缀；严格场景须用on_pre_save自定义插件，动态生成日期并正则校验头部。
Sublime Text 本身不支持开箱即用的「新建或保存时自动加作者信息」，必须靠插件或自定义逻辑驱动。官方设置里改 Preferences → Settings 没用，靠 snippet 或 key binding 也只解决手动触发问题——真要自动化，得明确选对机制：新建文件时注入，还是保存时检查补全。
FileHeader 插件是最快上手方案，但必须配对模板和变量
它不是装完就生效，关键在三处联动：
-
Package Settings → File Header → Settings-User里填好变量，比如：{ "Default": { "author": "Zhang San", "email": "zhang@example.com", "desc": "" } } - 进
Preferences → Browse Packages → FileHeader/template/header/，找到对应语言的.tmpl文件（如python.tmpl），确保里面用了{{author}}、{{email}}这类占位符，且拼写和 Settings-User 里完全一致 - 新建文件后必须立刻保存为指定后缀（如
.py），否则插件无法识别语言类型，不会渲染模板
常见失败点：Settings-User 里写成 "Author"（首字母大写），但模板里是 {{author}} ——大小写不匹配就留空；或者保存前没选后缀，Sublime 默认当 Plain Text 处理，跳过所有语言相关逻辑。
on_pre_save 自定义插件才是真自动，适合团队统一规范
FileHeader 对保存事件响应弱，也不支持「已有头部就不重复加」的判断。如果要求严格（比如 CI 检查头部必须存在、日期必须是保存时间），就得自己写 Python 插件：
- 监听
on_pre_save事件，不是on_post_save（后者已写入磁盘，改了也白改） - 用正则检查文件开头 3 行是否含
# -*-、/**、//、# @Author等标记，有则跳过 - 模板从
Packages/User/file_header_template.json读取，避免硬编码，方便 Git 同步团队配置 - 日期必须用
datetime.now().strftime("%Y-%m-%d")动态生成，不能写死或依赖 snippet 的${date}（它只在插入瞬间解析）
注意：插件代码里调用 view.insert() 要传 edit 对象，且位置必须是 0（文件开头）；直接 view.replace(edit, region, text) 替换前几行更稳妥，避免空行错位。
snippet 只适合手动触发，别指望它自动运行
很多人误以为建个 .sublime-snippet 就能“自动”加头，其实它本质是快捷补全工具：
- 触发靠
<tabtrigger>header</tabtrigger>，必须手动输header再按 Tab -
${date}在 snippet 里不自动更新，实际插入的是当前时间字符串，不是动态值 -
<scope>source.python</scope>能限定语言，但无法阻止你在 .txt 文件里误触发 - 想让新建文件一打开就带头？不行。除非你绑定一个
new_file事件插件去自动触发该 snippet，那又绕回插件方案了
所以 snippet 更适合快速补全函数级注释，或作为插件失效时的备用手段，不是自动化解法。
真正难的不是加一行作者名，而是让这个行为稳定、可维护、不污染非目标文件。模板路径写错、正则漏掉某种注释风格、日期格式和团队规范不一致——这些细节出问题，比功能没实现还难排查。
