korofileheader 的 fileheader.custommade 必须手动覆盖全局设置，因默认仅读取用户级 settings.json，无法满足企业多项目差异化版权模板需求；需在各项目根目录配置独立 .vscode/settings.json，结合变量如 ${year}、${filedirname}/${filename} 实现安全、稳定、可迁移的头部注释。
KoroFileHeader 是当前 VSCode 中唯一能稳定支撑企业级版权模板的插件，其他同类插件（如 Auto Comment Blocks、Document This）不支持多项目差异化配置、Git 作者自动提取、或 last-modified 时间节流控制。
为什么 koroFileHeader 的 fileheader.customMade 必须手动覆盖全局设置
企业项目常需区分「内部系统」「开源组件」「客户定制版」三类代码头，而插件默认只读取用户级 settings.json。若直接改那里，所有项目都会套用同一套版权文案——比如把客户 A 的保密声明塞进开源仓库，风险极高。
- 必须在每个项目根目录放一个
.vscode/settings.json，写入独立的fileheader.customMade - 模板里禁止硬写年份，改用
"copyright": "© ${year}–${year} Tech Group"—— 插件会自动展开为© 2024–2024，但注意它不支持跨年起始年（如2020–2024），得靠脚本预生成或人工维护 - 公司邮箱域名若含特殊字符（如
tech-group.com），记得用双引号包裹，否则 JSON 解析失败导致整个插件静默失效
fileheader.configObj 里这几个键值不设就等于没配
很多人装完插件按 Ctrl+Alt+I 没反应，查来查去发现只是因为关键开关关着。
-
"autoAdd": true：新建空文件时自动插入头部注释（默认false） -
"annotationStr": {"head": "/*", "middle": " * ", "end": " */"}：决定注释符号风格，Python 必须设为{"head": "#", "middle": "# ", "end": "#"}，否则生成//会被解释器报错 -
"throttleTime": 60000：控制LastEditTime更新频率，默认每秒刷一次，多人协作时极易引发 Git 冲突；设成 60000（1 分钟）可大幅降低冲突概率
Git 用户信息被误读成 root@localhost 怎么办
插件默认调用 git config user.name 获取作者，但开发机若未初始化 Git 或用了容器环境，就会 fallback 到系统用户名——结果是所有文件头都标着 root，法律效力归零。
- 优先在项目级
.vscode/settings.json中显式写死："author": "张三 <zhangsan>"</zhangsan> - 若真要动态读 Git，确保项目根目录存在
.git/config，且其中[user]段落完整：name = 张三、email = zhangsan@tech-group.com - 避免用
git config --global设置，团队成员全局配置不一致时，author字段会在不同人机器上渲染出不同值
函数注释生成后参数类型全丢，是不是插件坏了
不是插件问题，是语言模式没识别准。VSCode 的 koroFileHeader 函数注释依赖语言服务器提供的 AST 信息，如果右下角显示 Plain Text 或 JavaScript React 而非纯 JavaScript，它根本拿不到 param 类型。
- 新建
.js文件后，先点右下角语言模式，选JavaScript（不是JavaScript React），再保存，最后按Ctrl+Alt+T - TypeScript 项目必须确认已安装
ESLint或TypeScript Server，否则@param {string}中的{string}为空 - Python 需额外装
Python Docstring Generator插件配合使用，koroFileHeader自身对def f(a: int) -> str:的解析能力极弱
企业场景下最易被忽略的是 FilePath 字段——它默认输出绝对路径，一旦代码迁移到 CI 环境或不同开发者机器，路径就失效。务必在 fileheader.customMade 中设为 "FilePath": "${fileDirname}/${fileName}"，用插件内置变量保持相对路径稳定。
