SignatureHelp 不触发需先确认语言模式是否正确（如typescript而非Plain Text）及触发字符是否匹配（如'('或','），再检查SignatureInformation的label非空、parameters完整、activeSignature索引有效，最后验证provideSignatureHelp中响应token取消且无阻塞操作。
SignatureHelp 不触发？先确认语言模式和触发字符
SignatureHelp（函数参数提示）不弹出，90% 的情况不是插件坏了，而是根本没被触发。VSCode 只在特定语言模式下、且光标落在预设触发字符后才调用 provideSignatureHelp。
检查右下角状态栏显示的语言模式是否为实际目标语言（如 typescript、javascript 或 vue），而不是 Plain Text 或 JSON；若不对，点击切换或按 Ctrl+Shift+P → Change Language Mode 手动指定。
注册时传入的触发字符必须精确匹配用户输入行为：
-
'('触发于输入左括号瞬间（如foo(） -
','触发于输入逗号后（如foo(a,） - 若注册了
'('但用户写的是foo<string>(（带泛型），部分语言服务可能因解析失败跳过调用 - TypeScript/Volar 等语言服务器默认已注册这些字符，自定义 Provider 若重复注册，可能被后加载者覆盖
签名提示内容为空或错乱？检查 SignatureInformation 构造逻辑
返回的 SignatureHelp 对象里，signatures 数组不能为空，且每个 SignatureInformation 至少要有 label 字段（即函数签名字符串），否则 VSCode 会静默丢弃该签名。
常见构造错误：
- 直接 new
vscode.SignatureInformation('')：空字符串 label 导致整个签名被忽略 - 只设置
label却漏掉parameters数组：参数高亮和activeParameter定位会失效 - 参数用
new vscode.ParameterInformation('name')但未提供文档（documentation字段），导致 hover 提示空白 - 设置
help.activeSignature = 1但help.signatures只有 1 项（索引从 0 开始），越界导致提示不显示
建议始终用 new vscode.SignatureInformation('fn(a: number, b?: string)') 初始化，并显式 push ParameterInformation 实例。
调试 provideSignatureHelp 被调用但无响应？看 console 和 token 取消
在 provideSignatureHelp 函数开头加 console.log('sig help triggered', position)，然后打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），观察是否真被调用。没日志？说明注册失败或触发条件不满足。
如果日志有输出但提示仍不出现，重点检查 token.isCancellationRequested：
- VSCode 在用户快速移动光标或继续输入时会取消当前请求，若你的逻辑未及时响应
token，可能卡在异步解析中 - 避免在
provideSignatureHelp中做耗时同步操作（如读文件、正则全量匹配）；必须异步时，先判断token.isCancellationRequested再 await - 返回
undefined或 Promise.reject() 会被 VSCode 当作“无签名可提供”，不会报错但也不显示提示
多签名重载下 activeSignature 错位？别硬编码索引
当函数有多个重载（如 TypeScript 中的 overload），SignatureHelp 需要根据当前参数数量、类型推断匹配哪一版签名，并动态设置 activeSignature。硬写死 help.activeSignature = 0 会导致高亮错位，尤其在用户已输入部分参数时。
更可靠的做法：
- 解析当前光标前的参数列表（用
document.getText()+ 简单括号计数或 AST 工具如@babel/parser） - 遍历所有候选签名，比对参数个数与可选性，找出最匹配的一个索引
- 将该索引赋给
help.activeSignature，并基于当前逗号位置算出activeParameter - 若无法确定，宁可不设
activeSignature（保持 undefined），VSCode 会默认高亮第一个
这个逻辑看似复杂，但恰恰是用户感知“提示是否智能”的关键——很多人以为 SignatureHelp 就是静态贴标签，其实它的核心价值正在于上下文感知的动态匹配。
