支持中文触发，但需显式配置中文标点为triggerCharacters、监听onType事件并校验Unicode范围，且须精准注册language ID而非使用'*'通配符。
vscode.languages.registerCompletionItemProvider 支持中文触发吗
支持，但默认行为不自动适配中文输入场景。VS Code 的 registerCompletionItemProvider 本身不限制语言或字符集，但「触发时机」取决于两个关键配置：触发字符（triggerCharacters）和激活事件（activationEvents）。中文补全常失败，多数是因为开发者只填了 ['.', '('] 这类 ASCII 字符，漏掉了中文标点或输入法上屏瞬间的时机。
常见错误现象：console.日志 手动输入后没补全、中文变量名（如 用户信息）无法被识别为上下文、拼音输入法候选框弹出时补全直接消失。
- 中文标点需显式加入
triggerCharacters，例如['.', '（', '【', '「'] - 若想在中文输入法「上屏后」立即触发（比如输入完「日志」按空格），需监听
onType激活事件，并在provideCompletionItems中检查position.character - 1位置是否为中文 Unicode 范围（\u4e00-\u9fa5或扩展区） - 注意：输入法 IME 在组合状态（正在打字未上屏）时，VS Code 文本编辑器实际内容为空或含占位符，此时不应触发补全，否则会干扰用户
中文补全项的 label 和 insertText 怎么设才不乱码
label 是显示给用户的文本，insertText 是真正插入编辑器的内容；两者都必须用标准 UTF-8 字符串，VS Code 默认完全支持中文。但容易踩的坑是：用 JavaScript 字符串拼接时混入不可见控制字符，或从外部 API 获取数据后未做清洗。
使用场景：你从本地 JSON 配置读取「常用日志模板」，其中一项是 {"label": "错误日志", "insertText": "console.error('${1:msg}');${0}"} —— 这种写法完全可行，且支持中文占位符名（${1:错误信息}）。
-
label可含 emoji、中文、英文混合，不影响排序（VS Code 按 label 字典序排，中文按 Unicode 码点） -
insertText若含制表符或换行，必须用\t、\n转义，不能直接写物理字符 - 避免从剪贴板/第三方接口直接 .trim() 后就塞进
insertText，某些富文本粘贴会带零宽空格（\u200b），导致插入后光标错位
为什么中文补全在 TypeScript 文件里正常，但在 .vue 或 .md 里不生效
根本原因是 registerCompletionItemProvider 的第一个参数指定了作用语言范围。传 '*' 确实能覆盖所有语言，但 VS Code 内部对 .vue、.md 这类多语言文件做了特殊处理：它们被拆分为多个 language ID（如 vue-html、vue-script、markdown），'*' 并不等价于“所有子语言”。
性能影响明显：盲目注册到 '*' 会导致插件在每个编辑器打开时都被激活，即使用户只写 Markdown；而精准注册可延迟加载、减少内存占用。
- 查当前文件 language ID：打开一个
.vue文件 → 按Ctrl+Shift+P→ 输入Developer: Inspect Editor Tokens and Scopes→ 看右上角显示的languageId - 推荐做法：在
package.json的activationEvents里声明具体 language ID，例如["onLanguage:typescript", "onLanguage:vue", "onLanguage:markdown"]，并在activate中分别注册对应 provider - 若坚持用通配，可改用数组形式：
['typescript', 'javascript', 'vue', 'markdown', 'plaintext']，比'*'更可控
中文补全响应慢，怎么定位是网络还是解析逻辑的问题
补全延迟超过 300ms 就会被用户感知为卡顿。VS Code 对 provideCompletionItems 有隐式超时（约 500ms），超时后直接丢弃结果并静默失败——你不会看到报错，只会发现「该出现的时候没出现」。
最容易被忽略的点：在补全逻辑里同步读取大 JSON 文件、调用未加缓存的 HTTP 接口、或对整行文本做正则全局匹配（尤其含中文时，/[\u4e00-\u9fa5]+/g 在长文本中性能极差）。
- 用
console.time('completion')+console.timeEnd('completion')包裹provideCompletionItems主体，确认耗时是否真在函数内 - 检查是否有
fs.readFileSync：必须换成异步fs.readFile+await，否则阻塞整个 Extension Host 进程 - 中文正则慎用
.test()或.match()，优先用字符串方法如includes()、indexOf()判断简单存在性
复杂点在于：输入法上屏、编辑器重排版、补全列表渲染三者时间重叠，用户感觉「卡」未必是你的代码慢，可能是 VS Code 渲染线程被其他插件拖累。建议关掉 Copilot、Codeium 等同类 AI 插件后单独测试。
