必须安装Microsoft官方中文语言包并执行Configure Display Language命令选择zh-cn才能启用VS Code中文界面,插件仅提供翻译文件而不自动生效,手动编辑locale.json是兜底方案。

安装中文语言包必须认准 Microsoft 官方插件
装错插件是“部分中文部分英文”的根源。VS Code 本身不带中文资源,所谓汉化全靠 Chinese (Simplified) Language Pack for Visual Studio Code 提供翻译文件,而它只负责打包,不自动启用。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 严格核对发布者是 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 别点
Chinese Language Pack、VSCode Chinese或任何非 Microsoft 签名的插件——它们会导致命令面板乱码、设置项不翻译
启用中文必须执行 Configure Display Language 并选 zh-cn
插件装完只是“备好了字典”,真正告诉 VS Code “请翻这本书”的是 Configure Display Language 命令。这个步骤不能跳过,也不能靠改 settings.json 替代。
- 按
Ctrl+Shift+P(不是Ctrl+P)打开命令面板 - 输入并选择:
Configure Display Language - 在弹出列表中**明确点击**
zh-cn(小写、连字符,不是zh_CN、zh-hans、Chinese或zh) - 出现「是否重启窗口」提示时,一定点「是」——
Reload Window不会重读语言配置,无效
禁用中文只需改 locale 配置,无需卸载插件
想临时切回英文?不需要重装或禁用插件,改一行配置比卸载快得多。语言包仍可保留,后续切换回来也只需再执行一次 Configure Display Language。
- 再次运行
Configure Display Language - 把当前值
"locale": "zh-cn"改回"locale": "en" - 保存后必须彻底退出所有 VS Code 窗口(包括托盘进程),再全新启动
- 若命令面板失效,可直接编辑
locale.json文件(路径见下文),内容仅允许为:{"locale":"en"}
手动编辑 locale.json 是最稳的兜底方案
当命令面板卡死、输不了字、或选了 zh-cn 重启后仍是英文,说明 VS Code 没成功写入配置。此时绕过 UI,直接改配置文件是最稳解法。
- 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Electron进程 - 定位
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"}(无 BOM、无多余空格、无逗号、JSON 格式合法) -
settings.json里加"locale": "zh-cn"完全无效——这个字段在那里不被识别
终端、调试控制台、Git 输出、大部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真启用了。


















