VSCode插件中文文档支持取决于插件自身国际化实现，需提供package.nls.zh-cn.json等本地化文件并正确引用；否则即使系统设为中文，UI文字仍显示英文。
VSCode 插件市场本身不提供“中英文文档同步”功能，所谓“文档同步”，实际是指插件作者在 package.json 中声明的 contributes.configuration、contributes.commands 等字段所对应的 UI 文字（如设置项描述、命令标题、菜单文字），是否能在不同语言环境下正确显示——这完全取决于插件自身是否做了国际化（i18n）支持，而非市场或 VSCode 主程序控制。
插件文档文字是否显示中文，只看它有没有提供 locale 文件
VSCode 会根据当前 locale.json 设置（如 {"locale":"zh-cn"}）去加载插件目录下的对应语言资源。但前提是该插件在发布时：
- 在 package.nls.json（英文主资源）之外，提供了 package.nls.zh-cn.json
- 或使用了 vscode-nls-dev 工具生成多语言 bundle，并在 package.json 的 contributes 段中正确引用
- 否则即使你装了中文语言包、设了 zh-cn，插件的设置说明、右键菜单、弹窗提示仍显示英文
为什么有些插件中文描述乱码或缺失？
常见原因包括：
- 插件作者只写了 package.nls.json，没提交中文翻译文件（最常见）
- 中文翻译文件名写错，比如用了 package.nls.zh_CN.json（下划线）而非 package.nls.zh-cn.json（连字符），VSCode 不识别
- 插件使用了硬编码字符串（"Enable auto-format"），绕过了 NLS API，这类文字永远无法翻译
- 插件未声明 engines.vscode 兼容新版，导致 i18n 加载逻辑失效（VSCode ≥1.80 后更严格）
如何快速验证某个插件是否支持中文文档
不用等安装后翻菜单，直接查源码或发布页：
- 在插件市场页面点「Resources」→「Extension Manifest」，查看 contributes 下各字段的 description、title 是否包裹在 %key% 里（如 "%config.formatOnSave%"）
- 在插件 GitHub 仓库根目录搜 package.nls.zh-cn.json，存在且非空即大概率支持
- 安装后打开设置页（Ctrl+,），搜索该插件名，观察设置项描述是否为中文；若仍是英文，基本可判定未提供翻译
- 注意：调试面板、终端输出、Git 提示等不属于插件 UI 范围，它们的语言由系统 locale 或 Git 配置决定，和插件无关
真正容易被忽略的是：插件文档的中文化是作者行为，不是 VSCode 同步机制能干预的。你没法靠 Settings Sync 把别人的英文描述“变”成中文，唯一可控的是——选那些明确发布了 .zh-cn.json 的插件，或给作者提 PR 补翻译。
