KoroFileHeader插件不生效主因是自动插入被禁用或语言未识别，需开启fileheader.cursorMode、配置支持后缀、显式设置author和dateStyle，并用工作区settings.json实现多项目差异化模板。
VSCode安装KoroFileHeader插件后不生效
插件装了但按 Ctrl+Alt+I 没反应，或者新建文件没自动加注释——大概率是默认禁用了自动插入，或语言未被识别。
- 检查设置里
"fileheader.cursorMode"是否为false（禁用状态），改成true才能触发快捷键 - 确认当前文件后缀在插件支持列表中：比如
.ts默认支持，但.astro或自定义后缀需手动加到"fileheader.customMade"的language配置里 - 新建空文件时，VSCode 可能尚未识别语言模式（右下角显示“Plain Text”），先选对语言（如 JavaScript / Python）再保存，否则插件不触发
版权模板里作者名、日期总不对
插件默认读取系统用户名和当前时间，但常被本地 Git 配置或环境变量干扰，导致 author 写成 root 或 localhost，date 格式也不统一。
- 优先在用户 settings.json 中显式配置：
"fileheader.configObj": { "author": "张三", "dateStyle": "YYYY-MM-DD HH:mm:ss" } - 避免依赖
git config user.name，因为插件可能读取全局 Git 配置而非项目级，多人协作时容易串 -
lastModified字段默认关闭，如需更新时间，得单独开"fileheader.autoAddTime": true，且注意它只在保存时刷新，不是实时
不同项目需要不同头部格式（如公司/开源/个人）
全局配置一统到底，但实际开发中，内部项目要带保密声明，开源项目要 MIT 声明，个人脚本又想极简——硬塞进一个模板会互相污染。
- 用工作区
.vscode/settings.json覆盖用户级配置，比如在公司项目根目录加："fileheader.customMade": { "description": "内部系统组件", "copyright": "© 2024 XX科技有限公司. All rights reserved.", "license": "CONFIDENTIAL" } - 模板中避免写死路径或版本号，改用变量：
fileName: ${filename}、filePath: ${filedir}/${filename}，这些由插件运行时解析，更可靠 - 如果某类文件（如测试文件）完全不需要头部，可在工作区配置里加
"fileheader.ignore": ["**/*.test.js", "**/mock/**"]
快捷键冲突或注释符号错乱（比如 Python 用 // 而非 #）
按下 Ctrl+Alt+I 后生成的注释用了错误语法，或根本没响应——通常是语言标识不准，或快捷键被其他插件劫持。
- 打开命令面板（
Ctrl+Shift+P），搜File Header: Insert File Header，手动执行一次，看是否报错；若提示 “no language mode”，说明当前编辑器没设语言 - 检查快捷键绑定：在键盘快捷方式里搜
fileheader，确认Ctrl+Alt+I对应的是fileheader.insertHeader，不是被Auto Rename Tag之类插件占用了 - 注释符号由 VSCode 的语言配置决定，不是插件控制。如果 Python 文件里出现
//，说明语言模式被误设为 JavaScript，右下角点开语言选择器修正即可
真正麻烦的不是配一次，而是跨项目、跨团队时，.vscode/settings.json 往往被 .gitignore 掉，或有人手动删掉——所以关键字段（如 author、license）最好收敛到 workspace 级配置，并定期同步给新成员。
