korofileheader比document this更适合文件级注释，因其专为文件头部元信息设计，支持自动更新lasteditors和lastedittime，确保团队协作中注释可信；而document this仅面向函数/类jsdoc生成，缺乏文件头支持，易导致手动补全、更新遗漏与git冲突。
为什么 koroFileHeader 比 Document This 更适合管理文件级注释
Document This 主要面向函数/类的 JSDoc 生成，对文件头部注释支持弱或无；koroFileHeader 则专为文件级元信息设计，且天然支持自动更新 LastEditors 和 LastEditTime —— 这在团队协作中直接决定注释是否“可信”。
常见错误是装了 Document This 后误以为能一键补全文件头，结果手动补、漏更新、多人编辑冲突频发。
使用场景明确：新文件创建、Git 分支切换后重开文件、PR 前自查文档完整性。
性能影响几乎为零，但若配置了 throttleTime（如设为 60000），可避免每秒保存都触发时间刷新，减少 Git diff 噪音。
koroFileHeader 的快捷键冲突与修复方法
Windows 下 Ctrl+Alt+I 和输入法切换、某些远程桌面工具冲突最常见；Mac 上 Ctrl+Cmd+I 容易被浏览器接管。
解决方式不是换插件，而是重绑定：
• 打开 VSCode 快捷键设置（Ctrl+K Ctrl+S）
• 搜索 koroFileHeader
• 右键对应命令 → “更改键绑定”，输入新组合（如 Ctrl+Shift+H）
• 保存后无需重启，立即生效
注意：不要用 F1 调出命令面板再搜 “fileheader” 手动执行——这绕过快捷键逻辑，无法触发自动字段填充（比如 FilePath 不会写入）。
如何让文件头部注释不随每次保存乱改 LastEditTime
默认行为是“每次保存都更新时间”，这会导致无关代码修改也污染 Git 记录。
关键配置项是 throttleTime，必须写在 fileheader.configObj 里：
• 打开 settings.json
• 添加：
"fileheader.configObj": {<br> "throttleTime": 300000<br>}
单位是毫秒，
300000 = 5 分钟内只更新一次时间• 同时建议把
LastEditTime 字段从 customMade 中移除，交由插件自动控制，否则手动写的值会覆盖自动逻辑• 若团队按周发布，可设为
604800000（7 天），彻底规避日常编辑带来的时间抖动
函数注释提取参数失败的三个典型原因
koroFileHeader 的 Ctrl+Alt+T 提取参数依赖语法解析，不是正则硬匹配，容易卡在边界情况：
• 函数定义跨多行且括号未对齐（如参数分行写但没缩进），插件会漏掉后续参数
• TypeScript 类型标注用了复杂泛型（如 Promise<array>></array>），插件可能截断为 Promise<br>• 使用箭头函数且无显式 <code>return 类型（如 const fn = (a: number) => a + 1），@return 字段为空
临时 workaround：光标放在函数名上再触发，比放空行更可靠；长期方案是配合 ESLint 的 jsdoc/require-returns 规则，在保存时校验而非依赖插件生成
