Atom需依赖atom-file-header插件实现文件头部自动插入作者和时间注释，必须手动配置Author Name、Template（Python模板须顶格）、Date Format三项，变量如${author}和${date}仅首次插入时求值，刷新需手动触发Ctrl+Alt+I。
Atom 本身不提供文件头部自动插入作者、时间等元信息的功能，必须依赖插件；yozi.vscode-fileheader 是 VSCode 的插件，不能在 Atom 中使用——别搜错平台。
Atom 能不能原生实现头部注释自动填充
不能。Atom 核心不包含文件模板或变量注入机制，editor:toggle-line-comments 和 editor:toggle-block-comment 只处理代码行内注释，不生成文件头。所有「新建文件即带作者/日期」的需求，都得靠第三方包补足。
用哪个 Atom 插件配头部注释最稳
推荐 atom-file-header（ID：atom-file-header），不是 file-header 或 auto-header——后者已多年未更新，且不支持动态变量。
- 它支持
${author}、${date}、${datetime}、${filename}等变量，语法简单，无运行时依赖 - 配置项全在 Settings → Packages →
atom-file-header→ Settings 里填，不用改config.cson - 关键配置必须设三项：
Author Name（手动输，不读 Git）、Template（必须顶格写，尤其 Python）、Date Format（如YYYY-MM-DD HH:mm:ss） - 触发方式：新建文件后按
Ctrl+Alt+I（Win/Linux）或Cmd+Alt+I（macOS），不是保存自动触发
为什么模板写了 ${author} 却显示空或系统用户名
因为 atom-file-header 不读取 Git 配置，也不调用系统命令，它只认自己设置页里的 Author Name 字段。如果留空，就真为空；如果填了「张三」，所有 ${author} 就渲染为「张三」。
- Python 模板必须顶格（即第一列开始写
#），否则缩进错位，注释失效 -
${date}和${datetime}输出格式由Date Format控制，填YYYY-MM-DD才出 2026-06-08，填错成yyyy-mm-dd（小写）会输出字面量 - Vue / JSX 文件需手动切换 grammar 到
source.js或source.ts，否则插件不响应——右下角状态栏显示text.html.vue时无效
真正容易被忽略的是：变量只在首次插入时求值，后续保存不会刷新 ${date}；想更新时间，得再次执行 Ctrl+Alt+I，而不是靠「自动保存」联动。
