应安装 ID 为 yozi.vscode-fileheader 的 File Header 插件，它持续维护、无 Node.js 依赖、支持多语言；配置需设 author、customTemplates 和 date 格式，Python 模板须顶格，${update} 需手动触发更新。
直接用 File Header 插件（ID: yozi.vscode-fileheader）配好就能用，不用写脚本、不依赖 Node.js，Python/JS/TS/Go 全支持。关键不是“能不能”，而是模板语言键名对不对、${update} 到底怎么刷新、以及 Python 模板顶格这事容易被忽略。
装哪个插件？别选错 ID
别搜 “fileheader” 就随便点安装——已停止维护的 vscode-fileheader 和新维护的 File Header（作者 yozi，ID yozi.vscode-fileheader）名字太像，但后者才持续更新、无运行时依赖、变量支持更稳。
- 在扩展市场搜
yozi.vscode-fileheader，认准发布者是yozi - 装完不用重启，但得手动触发一次：新建一个
.py文件 → 点右下角语言模式 → 选Python（别留“Plain Text”）→ 按Ctrl+Alt+I - 如果没反应，立刻去设置里搜
fileheader.cursorMode，确保值是true
settings.json 必配三项：author、customTemplates、date 格式
插件不会读 Git 用户名，也不会猜你用什么注释语法，全靠配置驱动。缺任何一项，新建文件就空着作者或插错 // 到 Python 里。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
"fileheader.author": "张三"—— 必须显式写，否则是空或系统用户名 -
"fileheader.customTemplates"必须按语言分对象，例如：{ "python": { "Author": "${author}", "Date": "${datetime}", "LastEditTime": "${update}" }, "javascript": { "Author": "${author}", "Created": "${datetime}", "Last Modified": "${update}" } } -
${datetime}输出带时间（如2026-04-29 05:14:22），${date}只有日期；别混用
为什么保存后 ${update} 不变？它根本不是自动的
${update} 字段不是“每次保存都覆盖”，而是仅在你手动执行 File Header: Update File Header 命令时才写入当前时间。这是设计逻辑，不是 bug。
- 默认没快捷键，进
Keyboard Shortcuts搜该命令，建议绑成Ctrl+Alt+U - 想保存即更新？得关掉插件默认行为，再配
editor.codeActionsOnSave+ 自定义脚本——但会丢跨语言兼容性，不推荐 -
${update}值和git log -1无关，它只认你上次手动点更新的时间
Python 模板顶格写，否则缩进全乱
Python 对缩进敏感，而插件插入头部注释时，会把模板内容原样贴到文件开头。如果模板里某行开头有空格或 Tab，整个文件代码就会右移一格，导致 SyntaxError。
- 检查你的
python模板：每行必须顶格，不能有任何前置空格（包括注释引号前） - 别写成：
"\"\"\""
，要写成："\"\"\""
（引号紧贴行首） - 确认
"editor.insertSpaces": true开启，且换行符设为LF（Unix 风格），避免 Windows 的CRLF和编辑器换行逻辑冲突
最常出问题的地方就三个：语言没手动切对、Python 模板多了一格空格、以为 ${update} 会自己动——盯住这三点，基本不会再卡在“生成了但格式错乱”或者“点了没反应”。
