新建.py文件无注释是因为语言模式未设为python且模板缩进错误：需手动切换语言模式为python，customtemplates.python字段必须顶格书写，否则#注释错位；${update}仅在手动执行更新命令时生效，非自动触发。
直接装 yozi.vscode-fileheader 插件，配好 fileheader.author 和 fileheader.customTemplates，新建文件就能出注释——前提是语言模式已正确识别（比如不能是 Plain Text），且模板里没写错缩进或注释符号。
为什么新建 .py 文件没注释？语言模式和模板缩进都得对
VSCode 不会自动猜你写的是 Python，新建空文件右下角显示 “Plain Text” 时，插件压根不触发。必须先点右下角 → 选 “Python”，再保存或按 Ctrl+Alt+I。
- Python 模板必须顶格写，
customTemplates.python里任何字段前面都不能有空格，否则生成的#注释会错位甚至被当成代码 - JavaScript/TypeScript 模板用
//，Go 用//，但 C/C++/Java 要用/* */包裹——这些全靠customTemplates里对应语言对象决定，不能共用一个模板 - 如果新建文件后仍无反应，立刻检查
fileheader.cursorMode是否为true（它控制快捷键是否生效）
fileheader.customTemplates 怎么写才不出错
这个配置是核心，写错一个键名或漏掉一层对象，整块模板就失效。它不是扁平结构，而是按语言嵌套的对象：
{
"python": {
"Author": "${author}",
"Date": "${datetime}",
"Description": ""
},
"javascript": {
"Author": "${author}",
"Created": "${datetime}",
"Last Modified": "${update}"
}
}
-
python、javascript这些键名必须和 VSCode 内置的语言 ID 完全一致（查法：Ctrl+Shift+P→ 输入 “Change Language Mode” → 看当前语言显示的 ID） -
${datetime}输出带时间（如2026-10-02 11:37:22），${date}只有日期，别混用 - 字段名（如
Author）是纯字符串，不带@或//；注释符号由插件根据语言自动加，你只管填内容
${update} 为什么新建文件时没值？它根本不是自动生成的
${update} 字段在新建文件时为空，这是正常行为。它只在你手动执行 File Header: Update File Header 命令时才写入当前时间——不是每次保存，也不是 Git 提交时更新。
- 默认没快捷键，进
Keyboard Shortcuts搜该命令，建议绑成Ctrl+Alt+U - 想保存即更新？得关掉插件原生逻辑，改用
editor.codeActionsOnSave+ 自定义脚本，但会丢掉多语言注释符号自动适配能力 -
${update}和git log -1完全无关，它只认你上次手动点更新的时间戳
最容易被忽略的是：插件不读 Git 配置，fileheader.author 必须显式写死，留空就是空行；还有 Python 模板顶格这事，缩进一多，生成的 # 就跑进函数体里了。
