Ctrl+Alt+I没反应主因是语言模式未正确识别（如新建文件为Plain Text需手动设为Python/JavaScript等），其次可能是fileheader.cursorMode设为false、插件冲突（如koroFileHeader与yozi.vscode-fileheader共存）、作者名未手动配置或Python模板首行缩进错误。
快捷键 Ctrl+Alt+I 为什么没反应？
多数情况下不是插件没装好，而是语言模式没识别对。VSCode 必须知道当前文件是 python、javascript 还是 typescript，才能匹配对应模板并触发插入逻辑。
常见卡点：
- 新建文件时默认是
Plain Text，得先点右下角语言栏，手动选成目标语言（比如Python） -
fileheader.cursorMode值被设为false（某些旧配置会默认关掉），需在 settings.json 中显式设为true - 插件冲突：同时装了
koroFileHeader和yozi.vscode-fileheader，后者会静默失效
Ctrl+Alt+I 插入的作者名为空或显示 “Do not edit”
作者名不会自动从 Git 或系统读取，必须手动配置。插件只认你写死的字符串，不执行命令也不查环境变量。
正确做法是任选其一：
- 全局设作者：
"fileheader.author": "张三"（推荐新手） - 字段级控制：
"fileheader.customMade": {"Author": "张三", "Date": "Do not edit", "LastEditTime": "Do not edit"}（优先级更高，适合团队） - 别写
"Author": git config user.name——这只会原样输出那串文字，不是执行命令
Python 文件头注释缩进错乱，第一行多了空格
Python 模板必须顶格写，任何前置空格或 tab 都会被当成代码缩进，直接破坏 PEP 8 规范。
检查你的模板定义：
- ✅ 正确：
"# @Author: ${author}"（开头就是#） - ❌ 错误：
" # @Author: ${author}"（开头有空格） - shebang 行如
#!/usr/bin/env python也得顶格，不能包在模板对象的head字段里带缩进 - 确认 VSCode 的
editor.insertSpaces和editor.detectIndentation设置一致，否则插件插入用空格、你编辑用 tab，混用导致对齐崩坏
想保存就自动更新 LastEditTime？别依赖 ${update}
${update} 或 LastEditTime 字段根本不会随 Ctrl+S 自动刷新，这是插件明确的设计行为，不是 bug。
真要实现保存即更新，只有两条路：
- 手动触发：绑定快捷键
File Header: Update File Header（建议设为Ctrl+Alt+U），每次改完自己按一下 - 放弃跨语言兼容性：关掉插件的自动行为，改用
editor.codeActionsOnSave+ 自定义脚本，但 Python/JS/Go 模板就得各自维护一套逻辑
最常被忽略的是：很多人以为 LastEditTime 跟 git log -1 --format=%cd 同步，其实它只记录你上次手动点“更新文件头”的时间点。
