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 插件：

学习导航

一款AI开发辅助工具，主要用于学习者优质的学习网址导航网站，适合需要提升相关任务效率的用户。

下载

• 监听 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 更适合快速补全函数级注释，或作为插件失效时的备用手段，不是自动化解法。

真正难的不是加一行作者名，而是让这个行为稳定、可维护、不污染非目标文件。模板路径写错、正则漏掉某种注释风格、日期格式和团队规范不一致——这些细节出问题，比功能没实现还难排查。