Sublime Text需插件实现自动添加作者信息：FileHeader插件需配置Settings-User变量、语言模板占位符及正确文件后缀；严格场景须用on_pre_sa ve自定义插件，动态生成日期并正则校验头部。
想让Sublime Text在新建或保存文件时，自动帮你加上作者信息？很遗憾，这个功能它本身并不自带。无论是修改Preferences → Settings，还是用代码片段（snippet）和快捷键绑定，都只能解决“手动触发”的问题。要实现真正的自动化，关键在于选对机制：你是想在新建文件时注入，还是在保存文件时检查并补全？
FileHeader 插件是最快上手方案，但必须配对模板和变量
对于大多数用户来说，安装FileHeader插件是上手最快的路径。但别以为装完就万事大吉了，它能否生效，完全取决于三个环节是否联动成功：
- 配置用户变量：首先，你得打开
Package Settings → File Header → Settings-User，在里面填好你的个人信息。比如，一个典型的配置是这样的：{ "Default": { "author": "Zhang San", "email": "zhang@example.com", "desc": "" } } - 匹配语言模板：接着，进入
Preferences → Browse Packages → FileHeader/template/header/目录，找到对应语言的模板文件（例如Python对应python.tmpl）。你得确保模板里使用的占位符，比如{{author}}、{{email}}，和你在Settings-User里定义的变量名完全一致。 - 及时保存并指定后缀：最后，新建文件后，必须立刻保存为正确的文件后缀（比如
.py）。如果文件还是无类型的“Plain Text”状态，插件就无法识别语言，自然也就不会渲染模板。
这里有几个常见的“坑”：Settings-User里变量名写成了"Author"（首字母大写），但模板里却是小写的{{author}}，大小写不匹配就会导致信息留空。或者，文件在保存前没有指定后缀，Sublime Text会将其当作纯文本处理，直接跳过了所有与语言相关的自动逻辑。
on_pre_sa ve 自定义插件才是真自动，适合团队统一规范
FileHeader插件虽然方便，但在处理“保存”事件时不够灵活，比如它通常不支持“如果文件已有头部注释就不再重复添加”这样的智能判断。如果团队有严格的代码规范，要求CI（持续集成）必须检查头部信息，并且日期必须是动态的保存时间，那么自定义一个Python插件才是更可靠的方案。
- 监听正确的事件：插件应该监听
on_pre_sa ve事件，而不是on_post_sa ve。因为只有在文件内容写入磁盘之前插入，修改才会生效。 - 智能校验头部：用正则表达式检查文件开头几行，看看是否已经包含了类似
# -*-、/**、//或# @Author这样的标记。如果找到了，就跳过，避免重复添加。 - 模板外部化：将注释模板内容放在一个独立的配置文件（比如
Packages/User/file_header_template.json）里读取，而不是硬编码在插件中。这样做的好处是，团队可以通过Git同步这个配置文件，统一格式。 - 日期动态生成：日期必须通过
datetime.now().strftime("%Y-%m-%d")动态生成。不能依赖snippet里的${date}变量，因为它只在插入的瞬间被解析一次，之后就固定不变了。
这里有个技术细节需要注意：在插件代码中，向视图插入内容时，需要调用 view.insert(edit, 0, text)，并传入edit对象，且位置参数必须是0（即文件开头）。更稳妥的做法是使用 view.replace(edit, region, text) 来替换文件开头的特定区域，这样可以更好地处理空行和已有内容。
snippet 只适合手动触发，别指望它自动运行
很多人可能会想，创建一个.sublime-snippet文件不就能自动添加头部了吗？这是一个常见的误解。Snippet本质上是一个快捷补全工具，它的工作方式是这样的：
- 依赖手动触发：它需要你输入特定的触发词（比如
header），然后按下Tab键才会展开。它不会在文件新建或保存时自动运行。 - 日期是静态的：Snippet中的
${date}变量在插入时会被替换成当前时刻的字符串，之后就不再更新，并非一个动态的值。 - 作用域有限制：虽然可以通过
source.python - 无法响应新建事件：想让新建的文件一打开就自动带有头部注释？仅靠Snippet是实现不了的。除非你写一个插件来监听
new_file事件，然后在这个插件里自动触发Snippet——这又回到了自定义插件的方案。
所以，Snippet更适合用来快速补全函数级别的注释，或者作为插件方案失效时的一个手动备用手段。它并不是实现自动化的正确答案。
说到底，真正的难点不在于“添加一行作者信息”这个动作本身，而在于如何让这个行为变得稳定、可维护，且不会误伤非目标文件。模板路径配置错误、正则表达式漏掉了某种注释风格、动态生成的日期格式与团队规范不一致——这些细节问题一旦出现，往往比功能完全没实现还要难以排查和解决。
