fileheader插件需手动开启auto_add_to_new_file并重启sublime text才能自动插入头部注释；快捷键ctrl+alt+t仅在语法识别正确的源码视图下生效；模板变量用双大括号语法，不同语言需配置supported_filetypes并匹配小写.tmpl文件。
FileHeader 插件装完默认不生成任何注释，必须手动开启 auto_add_to_new_file 并重启 Sublime Text 才能生效——这是 90% 用户卡住的第一步。
怎么让新建文件自动插入头部？
关键不是“装了插件”，而是“插件是否被激活”。FileHeader 默认关闭自动插入，所有配置都得写在 User Settings 里，且必须重启编辑器才加载。
- 打开
Preferences → Package Settings → FileHeader → Settings - User - 确保有且仅有一行未被注释的配置：
"auto_add_to_new_file": true - 删掉或注释掉
Settings - Default里的同名项（它会被 User 覆盖，但容易误判） - 改完必须彻底退出 Sublime Text（macOS 尤其注意：仅关闭窗口 ≠ 退出进程），再重开
为什么 Ctrl+Alt+T 没反应？
这个快捷键只在「语法识别正确」的源码视图下有效。它不是全局命令，也不响应 Plain Text、Console 或 Markdown 预览模式。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 检查右下角状态栏：显示
Python、JavaScript等才是合法作用域；显示Plain text就按不动 - 快捷键可能被其他插件劫持：进
Preferences → Key Bindings，搜索file_header，确认没有重复绑定或"disabled": true - 想换快捷键？直接在 User Key Bindings 里加一行：
{"keys": ["ctrl+shift+h"], "command": "add_file_header"} - 未保存的临时文件里，
${file_name}和${file_path}返回空字符串，别拿它们做条件判断
如何让不同语言用不同模板？
FileHeader 不靠文件后缀猜语言，而依赖 Sublime 的 syntax scope。你得告诉它哪些语言类型该套哪个 .tmpl 文件。
- 在 Settings - User 里加
"supported_filetypes"，例如："supported_filetypes": ["python", "javascript", "cpp"] - 对应模板文件名必须小写、无空格、带
.tmpl后缀，比如python.tmpl、javascript.tmpl - 模板变量是双大括号语法：
{{author}}、{{create_time}}，不是${author}（那是 Snippet 语法，混用会静默失效） - Vue 单文件组件的
<script></script>块要用//或/* */注释，不能用<!-- -->，否则解析失败
团队项目怎么统一头部格式？
靠每人改 Settings - User 行不通：有人漏配、有人手抖、有人用错路径分隔符。真正可控的是 per-project 配置。
- 菜单栏
Project → Edit Project，在"settings"下加"file_header"块 - 强制指定
"author"（留空会报错）、"license"（如"MIT"）、"description_format"（比如要求含@desc字段） - Windows 用
\、macOS/Linux 用/，模板路径建议全用正斜杠并实测跨平台行为 - 禁用个人 Settings - User 的最简单验证法：用
Package Control: Disable Package临时关掉 FileHeader，看项目头是否还生成——如果没了，说明项目配置真在起作用
最容易被忽略的点：首次新建文件时，头部必须由 FileHeader 自己生成；如果手敲一个看似一样的注释，后续保存不会触发更新逻辑——插件只认自己生的孩子。
