vscode需借助auto insert header扩展实现文件头部注释，推荐配置onsave触发、动态模板路径及变量化author/copyrightyear；首次保存才注入，旧文件需手动插入。
VSCode 本身不内置自动插入文件头部注释的功能，必须依赖扩展 + 配置组合实现，且不同语言、不同项目结构下行为差异明显——直接装个插件就一劳永逸的想法容易踩坑。
用 Document This 还是 Auto Insert Header？
前者主打 TypeScript/JavaScript 的函数/类注释，对文件级版权头支持弱；后者轻量专注文件头，但默认不识别项目根目录下的 license.txt 或统一版权模板。实际推荐 Auto Insert Header（作者：Robin Chen），它支持基于工作区路径动态读取模板，且可绑定到保存触发，更可控。
- 安装后需手动启用：
"auto-insert-header.enable": true - 禁用默认的“新建文件时插入”（易误触），改用保存时注入：
"auto-insert-header.onSave": true - 若项目含多个子模块，把模板文件放在各子模块根目录下，而非工作区根目录，否则跨语言识别会失效
fileheader.configObj 中 beforeAnnotation 和 afterAnnotation 怎么配？
这是控制注释块“包裹样式”的关键参数，不是所有语言都适用同一套。比如 Python 要求首行是 #!/usr/bin/env python3，就必须用 beforeAnnotation 插入；而 Go 文件顶部禁止空行，afterAnnotation 若多加了换行就会被 gofmt 报错。
- Python 示例：
"beforeAnnotation": ["#!/usr/bin/env python3", ""]（第二项空字符串表示换行） - Go 示例：
"afterAnnotation": []（留空，避免多余空行） - 注意：数组内每项为一行内容，不要手动拼接
\n，插件会自动处理换行
如何让版权信息随项目变化自动替换 author 和 copyrightYear？
硬编码 author 在全局设置里会导致多人协作时信息错乱；写死 copyrightYear 则每年都要手动改。正确做法是用变量 + 工作区配置隔离。
- 在项目根目录的
.vscode/settings.json中定义："fileheader.customMade": { "Author": "Your Team Name", "Copyright": "© ${nowYear} Your Company" } -
${nowYear}是插件内置变量，保存时实时计算，无需脚本 - 避免使用
${user}—— 它读取的是系统用户名，Windows 下常为DESKTOP-XXXX，不可读 - 如果团队用 Git 管理作者邮箱，可配合
git config user.name写个简单 shell 脚本生成.vscode/settings.json，但别让插件直接调用git命令，会拖慢保存响应
最易忽略的一点：插件只在文件**首次保存**时注入头部，如果文件已存在内容（哪怕只有空格），它就不会动——这意味着从 Git 拉下来的旧文件、或粘贴代码后立刻保存的场景，注释根本不会出现。得手动触发 Ctrl+Shift+P → Insert Header，或者改用 editor.codeActionsOnSave 配合自定义命令补位。
