vscode插件命令无响应的主因是activationevents未配置或不匹配，导致插件未激活；命令id须与package.json中contributes.commands的command值完全一致，且必须同时声明于activationevents中。
插件配置必须绑定激活事件，否则注释命令不会加载
VSCode 插件不是装上就生效的，activationEvents 决定它何时被拉起。如果你写了生成注释的命令但按快捷键没反应，大概率是这里漏配了。
常见错误：只在 contributes.commands 里注册了 comment-generator.generate，却没在 activationEvents 中声明触发条件。
- 推荐写法：
"onCommand:comment-generator.generate"—— 用户执行该命令时才激活插件，轻量且安全 - 避免写
"*"或"onStartupFinished"，会导致插件一开就加载，拖慢启动速度 - 若想支持光标停在函数上自动提示，还需加
"onLanguage:javascript"等语言钩子，否则 JS 文件里也触发不了
注释模板不能硬编码中文字段名，得靠变量替换
直接在模板字符串里写 "@description 功能说明" 看似省事，但插件运行时无法识别这是要填充的内容——它只会原样输出，不会把“功能说明”替换成用户输入或 AST 分析出的实际描述。
真正有效的做法是用插件约定的变量语法，比如 $description$、$params$、$returns$，再在逻辑层解析上下文后赋值。
-
koroFileHeader用$description$，你得在fileheader.customMade里配好默认值，或在生成时弹窗让用户填 - 自己开发插件时，要用
vscode.window.showInputBox拿用户输入，或调vscode.languages.getFoldingRanges+ AST 解析函数签名来推导$params$ - 别用
${description}（ES6 模板字面量语法），VSCode 插件模板引擎不认这个，会直接报错或静默失败
AST 解析比正则可靠，但必须等语言服务就绪
想让注释准确反映参数类型和修饰符（比如跳过 @Transient 字段、识别 readonly），就不能只靠正则匹配函数行——它会把字符串里的 id、注释里的伪代码甚至匿名类里的同名变量全抓进来。
正确路径是走 Language Server Protocol（LSP）接口，但有个关键前提：语言服务得先 ready。
- 调
vscode.languages.getHover或vscode.languages.getDocumentSymbol前，务必检查vscode.languages.hasProvider返回 true - Java 场景下，等
textDocument/documentSymbol响应后再取字段列表；TS/JS 则依赖 TypeScript Server 的getSignatureHelpItems - 如果语言服务未加载（比如刚打开一个 .ts 文件，TS 插件还在初始化），强行调 API 会返回空数组或抛错，此时应降级为简单正则提取函数名+括号内容
多语言模板不能共用一套逻辑，必须按 languageId 分支处理
同一个 generateComment 命令，在 Python、C++、TypeScript 里要生成的注释格式完全不同：Python 要 """ + Google 风格，C++ 要 /** @param[in] x */，TS 则倾向 /** @param x - 描述 */。硬写一个通用模板只会哪边都不像。
最稳妥的做法是在插件主逻辑里根据 document.languageId 分发处理函数。
- Python：调
python.docstringGenerator.style设置读取用户偏好（google/numpy），再按规则拼@param和@return - C++：用
doxdocgen.c.functionTemplate配置项获取用户定义的 Doxygen 模板，而不是自己硬编码@brief位置 - TypeScript：优先复用 VSCode 内置的 JSDoc 补全逻辑（
typescript.languageServiceHost.getScriptSnapshot），比自己解析 AST 更稳
最容易被忽略的是：不同语言的“函数定义行”判定规则不同。Python 看 def，TS 看 function 或 const xxx = (，而 C++ 还得分清成员函数和自由函数——这些细节不拆开处理，生成的注释大概率挂错位置。
