必须粘贴全名“chinese (simplified) language pack for visual studio code”搜索并认准microsoft发布者,安装后执行configure display language命令设locale为"zh-cn"并彻底重启,缺一不可。

插件市场搜不到“中文插件”?别输关键词,直接粘贴全名
搜“中文”“汉化”“简体中文”大概率命中第三方仿冒包——图标模糊、描述含糊、带广告或乱码,装了也不生效。VS Code 官方唯一支持的简体中文语言包,全名是Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是Microsoft,扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans。
正确操作只有这一种:
按Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 → 在搜索框里严格粘贴全名 → 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项 → 点击Install。
常见错误现象:
• 搜索结果里第一个看起来像的,发布者却是“vscode-china”或“lang-pack-cn” → 跳过
• 安装后右下角弹窗提示“Reload Window”,点了也没变中文 → 这步不切换语言,只是重载界面
装完还是英文?关键一步:执行 Configure Display Language 命令
语言包只是“备好了翻译字典”,VS Code 默认仍用英文界面。必须手动告诉它“请用中文”,这步不能跳过,也不能靠设置界面里的旧选项。
操作路径很明确:
• 按Ctrl+Shift+P打开命令面板
• 输入并选择Configure Display Language
• 在弹出的 JSON 文件中,把"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹,zh_CN或zh-hans都无效)
• 保存后,必须点弹窗里的Restart按钮,或手动关掉所有窗口 + 杀掉后台进程再重开
容易踩的坑:
• 把zh-cn写成ZH-CN或zh_CN → 不生效
• 改完没重启,或只关闭当前窗口但后台Code.exe仍在运行 → 界面不变
• 多个中文插件共存(比如同时装了vscode-zh-hans-menu和官方包)→ 冲突导致部分菜单回退英文
命令面板打不开或没反应?直接编辑 locale.json 最稳
如果Configure Display Language命令搜不到、空白、报错,说明语言包没真正装好,或者 VS Code 没读到配置路径。这时候别折腾命令面板,直接编辑配置文件更可靠。
步骤要严格:
• 彻底关闭所有 VS Code 窗口,包括托盘/后台进程(Windows 查任务管理器中是否有Code.exe,macOS 查Electron)
• 用 VS Code 自己打开对应路径下的locale.json文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json
• 写入内容:{"locale":"zh-cn"},保存时确保为 UTF-8 无 BOM 编码
性能与兼容性影响:
• 此方法绕过 UI 层,适用于所有 VS Code 版本(包括 1.118 及以上)
• 不依赖插件市场网络状态,内网、教育网、强防火墙环境也适用
• 若文件已存在且内容非 JSON 格式(如空文件、乱码),直接覆盖即可
终端和调试器还是英文?这不是插件问题,是组件隔离
VS Code 的终端(Terminal)、调试控制台(Debug Console)、输出面板(Output)等模块使用独立的本地化逻辑,即使界面已中文,它们默认仍走系统 locale 或硬编码英文。
解决办法有限但有效:
• 终端内执行:code --install-extension MS-CEINTL.vscode-language-pack-zh-hans(强制刷新语言包依赖)
• 调试器英文项无法汉化是正常现象,官方未开放该层翻译接口
• 可搭配民间插件补全,如Chinese Menu(汉化右键菜单)、vscode-zh-hans-menu(深度汉化设置项),但仅限菜单文本,不影响核心功能
容易被忽略的地方:
• 汉化覆盖率约 85%,官方明确不承诺 100% 全量翻译
• 插件作者自行实现的 UI(比如某些 LSP 服务器的提示)不会受locale.json影响
• 如果你用的是企业版 VS Code(如 GitHub Codespaces 或 Azure DevOps 托管实例),语言设置可能被策略锁定,本地修改无效











