fileheader 插件默认不支持企业级版权模板动态注入，因内置模板缺失${company}、${copyright_year}等变量且author取系统用户名，需手动配置file_header_template并严格遵循json格式、空格缩进及settings–user编辑规范。
FileHeader 插件本身不支持企业级版权模板的动态注入，必须手动配置 file_header_template 并配合 author、company 等自定义变量才能落地。
为什么默认配置无法满足企业需求
插件开箱即用的 file_header_template 只含 ${name} 和 ${description}，没有 ${company}、${copyright_year} 或法律声明占位符。更关键的是，author 值默认取系统用户名（如 john），而非企业邮箱或规范署名（如 Zhang San <zhangsan></zhangsan>）。
常见错误现象：Ctrl+Alt+T 插入头部后出现 Author: john 或空 Company: 行，需人工补全——这直接破坏自动化前提。
- 企业要求版权年份为“2020–2024”格式，但插件原生不支持区间年份自动更新
- 多个子公司共用同一 Sublime 安装时，
author无法按项目目录切换 - 法律条款（如 MIT 声明）需缩进对齐，但默认模板不处理空格与换行
如何配置支持多公司/多作者的动态模板
核心是修改 Preferences → Package Settings → FileHeader → Settings – User，用 file_header_template 覆盖默认值，并通过 author、company 等字段注入真实信息：
{
"author": "Li Wei <liwei>",
"company": "Tech Group Co., Ltd.",
"file_header_template": [
"/**",
" * @file ${file_name}",
" * @brief ${description}",
" *",
" * @author ${author}",
" * @company ${company}",
" * @copyright Copyright (c) ${year}–${year} ${company}. All rights reserved.",
" * @license MIT License",
" */"
],
"year": "2024"
}
</liwei>
注意：${year} 是插件内置变量，但仅输出单年；若需“2020–2024”，必须手动写死起始年或借助外部脚本预生成——插件不提供 Git commit 时间解析能力。
- 不同项目需不同
company时，可为每个项目根目录建.sublime-project文件，在其中覆盖settings下的company和author -
file_header_template中每行字符串结尾不要加逗号，否则 JSON 解析失败导致插件静默失效 - 缩进必须用空格（非 Tab），否则生成的注释会错位
避免模板被意外覆盖的实操要点
Package Control 更新插件时，Settings – User 不会被重置，但新手常误操作 Settings – Default——改那里等于改源码，下次更新直接还原。
- 永远只编辑
Settings – User，且保存前确认右下角状态栏显示user而非default - 在团队中分发配置时，把上述 JSON 块存为
fileheader-company.json，让成员复制粘贴到自己的Settings – User，而非共享整个配置文件（避免混入个人路径） - 如果某次
Ctrl+Alt+T没反应，先检查 Sublime 控制台（Ctrl+`）是否报KeyError: 'author'——说明author字段缺失或拼写错误
真正难的不是写模板，而是让每个开发者本地的 author 值始终符合 HR 系统记录的全名+邮箱格式；一旦有人手输成 lisi 或漏掉 ，自动化就变成合规风险点。
