补全建议不显示中文是因为 CompletionItem.label 字段未设为中文字符串，需在 provideCompletionItems 中显式设置 label 为中文（如“打印日志”），insertText 可保持英文；同时确保系统编码为 UTF-8、字体支持 CJK、避免不可见字符及同步加载翻译。
插件开发时补全建议不显示中文？检查 languageId 和 triggerCharacters
VSCode 插件里的补全建议默认是英文，不是因为翻译缺失，而是 CompletionItem 的 label 字段你写了什么，它就显示什么。很多开发者直接照抄示例写 'console.log()'，结果补全框里永远是英文。真正要改的，是你的补全项构造逻辑。
- 确保
provideCompletionItems返回的每个CompletionItem的label是中文字符串，例如new vscode.CompletionItem('打印日志', vscode.CompletionItemKind.Function) -
insertText可以保持英文（如'console.log($1)'），它控制实际插入内容；label控制用户看到的提示文字 - 若用
vscode.SnippetString做插入，label仍需单独设为中文，否则补全面板只显示 snippet 的原始结构 - 别依赖
locale.json自动翻译——插件 UI 文字完全由你代码控制，VSCode 不会帮你把'log'映射成'日志'
中文 label 被截断或乱码？确认编码与字体渲染
补全面板里中文显示为方块或只显示前两个字，大概率不是插件问题，而是 VSCode 渲染层限制。尤其在 Windows 上未启用 UTF-8 系统编码时，CompletionItem.label 中的中文可能被截断。
- Windows 用户：进「设置 → 时间和语言 → 区域 → 管理语言 → 更改系统区域设置」，勾选「Beta 版：使用 Unicode UTF-8 提供全球语言支持」，重启系统
- Linux/macOS：确保终端和 VSCode 启动环境的
LANG是zh_CN.UTF-8或en_US.UTF-8（UTF-8 必须存在） - VSCode 内部字体默认支持中文，但若你自定义了
"editor.fontFamily"，请确认所选字体（如'Fira Code', 'Microsoft YaHei'）包含 CJK 字符集 - 不要在
label里混用全角/半角空格或特殊不可见字符，它们会导致宽度计算异常，触发截断
多语言用户想动态切换补全语言？别硬编码，用 context
你没法让 VSCode 自动根据系统 locale 把 label 翻译成中文或英文——插件运行时拿不到当前 UI 语言，vscode.env.language 返回的是编辑器启动时的语言，且不可变。真要支持多语言，得自己管。
- 在
activate里读取vscode.workspace.getConfiguration().get('yourExtension.language')，让用户在 settings.json 里配"yourExtension.language": "zh-cn" - 把所有提示文案抽成 JSON 文件（如
locales/zh-cn.json、locales/en-us.json），按 key 加载对应文本 - 避免在补全提供器里做异步加载翻译文件——
provideCompletionItems是同步函数，阻塞会导致补全卡顿甚至超时 - 如果只是内部团队用，直接写死中文更稳；面向全球发布才值得投入多语言架构
调试时看不到中文补全？检查 extension host 是否崩溃
补全没出来，右下角也无报错，但 DevTools Console 里有 Extension host terminated unexpectedly —— 这种静默失败最容易误判为“中文不支持”。实际常因中文字符串触发了未捕获异常，比如错误地用了 JSON.stringify 处理含 emoji 或生僻字的 label。
- 打开命令面板 →
Developer: Toggle Developer Tools→ 切到 Console 标签，输入代码触发补全，看是否有红色报错 - 常见坑：
CompletionItem.documentation若传了含 HTML 标签的字符串但没转义，会直接让 provider 失效 - 用
vscode.MarkdownString包裹富文本描述，而不是裸字符串 - 本地测试时，删掉
node_modules重装依赖，某些旧版vscode-test对中文路径支持不完整
