装完 fileheader 插件后新建文件不自动添加作者信息是正常现象,需手动启用 auto_add_to_new_file、配置 default 变量、设置 supported_filetypes、确保对应 .tmpl 模板存在且语法合法,并彻底重启 sublime text 后保存为有效后缀文件才生效。

装完 FileHeader 插件后,新建文件不会自动加作者信息——这是默认行为,不是插件坏了,必须手动开启并配对模板和变量才能生效。
必须在 Settings - User 里启用 auto_add_to_new_file
FileHeader 默认关闭所有自动注入,auto_add_to_new_file 在 Settings - Default 中是 false,且不会继承到 User 配置中。
- 打开
Preferences → Package Settings → FileHeader → Settings - User - 写入唯一一行:
"auto_add_to_new_file": true(不能加注释、不能拼错、不能多逗号) - 删掉或注释掉 Settings - Default 里的同名项,避免覆盖干扰
- 改完必须彻底退出 Sublime Text:macOS 要用 Activity Monitor 杀掉
Sublime Text进程,Windows/Linux 也要确认进程已结束,再重开
author 等变量必须显式声明在 Default 对象里
插件不会自动读取系统用户名或 Git 配置,{{author}} 这类占位符只有在 Settings - User 的 Default 块里定义了才会被替换。
- Settings - User 内容应类似这样(JSON 格式,注意括号和引号):
{
"Default": {
"author": "Your Name",
"email": "you@example.com"
}
}
- 变量名严格大小写敏感:
{{author}}对应"author",写成"Author"或"AUTHOR"就留空 -
create_time和last_modified_time是插件内置变量,不用手动设;但last_modified_by也得靠Default里定义才生效
语言模板 .tmpl 文件必须存在且匹配后缀名
插件只对识别为源码的文件生效,Plain Text 视图下完全不触发;且必须有对应后缀的小写 .tmpl 文件,比如 python.tmpl、vue.tmpl。
- 进
Preferences → Browse Packages → FileHeader/template/header/ - 检查是否有目标语言的模板:没有
typescript.tmpl?复制javascript.tmpl改名;没有html.tmpl?新建一个,内容用<!-- -->包裹变量 - 模板内注释语法必须合法:Python 用
#,C++ 用/* */,Vue 的<script></script>块用//,写错会导致整个头部渲染失败 - 新建文件后必须立刻保存为带后缀的文件(如
index.vue),否则右下角显示Plain Text,插件直接跳过
非默认后缀(如 .vue、.ts)要加 supported_filetypes
FileHeader 默认只支持 .py、.js、.java 等少数后缀,.vue 或 .ts 不会自动识别,除非显式声明。
- 在 Settings - User 中补充:
"supported_filetypes": ["vue", "ts", "html"](注意是小写字符串数组,不是.vue或vue.js) - 确保对应
vue.tmpl、typescript.tmpl已存在且变量写法一致 - 如果用了自定义模板路径,还要配
fileheader_custom_template,但多数情况不需要
最容易被忽略的是:改完配置不重启,或者新建文件没保存就关掉——插件只在保存动作后才解析语言类型并渲染模板。哪怕所有配置都对,只要文件没落地为 .py 或 .vue,它就当 Plain Text 处理,什么也不做。











