fileheader插件安装后不生效，需确认package control已正确安装并重启sublime text；必须在settings–user中启用"auto_add_to_new_file": true，配置author、date_format等变量，并确保支持的文件类型已加入supported_filetypes。
FileHeader插件安装后不生效？检查Package Control和重启步骤
插件装完没反应，大概率是没正确触发初始化。Sublime Text的Package Control安装插件后，FileHeader不会自动监听新建文件事件，必须手动触发一次“重载”或重启编辑器。
- 确认已通过
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板，输入Package Control: Install Package，再搜FileHeader并完成安装 - 安装完成后，**必须关闭所有Sublime窗口，再重新打开**——仅新建标签页或重启插件进程不够，
FileHeader的文件模板监听逻辑在启动时注册 - 如果仍无效，检查
Preferences → Package Settings → FileHeader → Settings是否为空白或语法错误；空配置文件会导致默认模板加载失败
如何让新建.py/.js等文件自动插入头部注释？改user配置而非default
默认模板只对部分后缀生效（如.py），且版权信息是占位符。要支持自定义扩展名并填入真实信息，必须修改FileHeader.sublime-settings的new_file_header和file_types字段。
-
new_file_header里用${author}、${email}等变量，它们的值来自author和email顶层字段，不是系统环境变量 - 想让
.ts文件也自动生成，需在file_types中添加"typescript": ["ts"]；注意键名必须是语言ID（查当前文件右下角状态栏显示的名称，比如TypeScript对应typescript） - 避免直接改
Default配置——每次插件更新会被覆盖，所有修改必须写在User配置里
时间戳格式不对、作者名乱码？Python strftime语法和编码陷阱
FileHeader用Python的strftime生成日期，但不支持%f（毫秒）或%z（时区），且Windows系统上中文路径/用户名可能引发UnicodeEncodeError。
- 安全的时间格式用
%Y-%m-%d %H:%M:%S，%Y是4位年份，%y是2位——写错会导致年份显示异常（如2025变成25） - 作者名含中文时，在
User配置里把author字段用双引号包裹，并确保Sublime Text本身编码为UTF-8（File → Save with Encoding → UTF-8） - 如果保存文件时报
UnicodeEncodeError，临时把author改成英文名测试，确认是编码问题后再统一处理项目文件编码
已有文件怎么补头部？别用Ctrl+N，要用命令面板触发
新建文件能自动加，但打开旧文件再保存不会追加——这是设计行为，不是bug。要给现有文件加头，得主动调用命令。
- 光标放在文件顶部（任意位置都行），按
Ctrl+Alt+T（Windows/Linux）或Cmd+Alt+T（macOS）——这是FileHeader: Add Header的默认快捷键 - 如果快捷键冲突，去
Preferences → Package Settings → FileHeader → Key Bindings查实际绑定，或手动从命令面板搜Add Header - 对批量文件，先用
Ctrl+Shift+F全局搜索匹配路径，再逐个打开+快捷键插入；插件不提供一键全项目注入功能
真正麻烦的是多语言项目里不同文件类型的模板不一致，比如Go文件要//而HTML要<!-- -->，每个file_types项下的header字段都得单独配，漏一个就只能手敲。
