fileheader插件需手动启用auto_add_to_new_file并配置supported_filetypes、模板文件及变量格式才能生效。必须在settings-user中设"auto_add_to_new_file": true,添加"supported_filetypes": ["vue","ts","html"],配置对应.tmpl模板和default变量(如{{author}}),且语法识别正确。

FileHeader插件必须手动开启 auto_add_to_new_file 才生效
装完 FileHeader 插件后新建文件没反应,不是插件坏了,是默认关着的。它不靠“新建动作”自动触发,只认配置项 auto_add_to_new_file 的布尔值。
打开 Preferences → Package Settings → FileHeader → Settings - User,确保有且仅有一行未被注释的配置:
"auto_add_to_new_file": true
常见错误包括:
• 把这行写在 Settings - Default 里(会被覆盖,且升级后丢失)
• 写了但前面加了 // 或 /* */ 注释掉
• 改完只保存设置,没彻底退出 Sublime Text(macOS 尤其注意:关闭窗口 ≠ 退出进程)
• 新建文件时右下角显示 Plain Text,插件直接跳过(语法未识别)
支持 .vue/.ts/.html 等非默认后缀要配 supported_filetypes + .tmpl 文件
FileHeader 默认只对 .py、.js、.java 等少数后缀生效。想让 .vue 或 .ts 也自动加头,得两步补全:
- 在 Settings - User 中添加
supported_filetypes,例如:"supported_filetypes": ["vue", "ts", "html"]
(注意:用小写英文名,不是.vue或vue.js) - 进 Preferences → Browse Packages… → FileHeader → template → header,确认存在对应
.tmpl文件:
• 没有vue.tmpl就新建一个
• 没有typescript.tmpl可复制javascript.tmpl改名
• 模板内注释符号必须匹配语言规范(如 HTML 用<!-- -->,Vue 的<script></script>块用//)
作者名、日期等变量必须用 {{author}} 且大小写敏感
模板里不能硬写 @Author: 张三,否则无法随项目切换,也不利于团队统一管理。动态内容必须走变量注入:
- 作者名、邮箱、公司等统一在 Settings - User 的
Default对象里声明:"Default": { "author": "李四", "email": "lisi@team.com" } - 模板中对应位置写
{{author}}、{{email}}、{{create_time}}(双大括号,且大小写完全匹配)
• 错写成{{Author}}或${author}都会渲染为空 -
date_format控制时间格式,例如:"date_format": "Y-m-d H:i:s"
(H是 24 小时制,h是 12 小时制;i是分钟,s是秒) -
{{file_name}}和{{file_path}}在文件未保存前返回空字符串,别拿它们做条件判断
保存时自动更新 last_modified_by 需要已有合法头部 + 正确触发
last_modified_by 和 last_modified_time 不是“开箱即用”,它依赖两个前提:
- 文件已存在合法头部(即开头几行含
/*、#、//等匹配注释起始符) - 保存动作必须落在插件监听范围内——也就是说,文件 syntax 必须正确(右下角不能是
Plain Text),且未被其他插件劫持快捷键或事件
如果改了代码但头部的 Last Modified 没变,先检查是否满足上述两点。另外,FileHeader 的保存时更新逻辑不会覆盖自定义字段(比如你加的 @version),但也不会主动补全——它只管自己认的变量。











