必须安装 microsoft 官方中文语言包并执行 configure display language 命令选择 zh-cn,再重启窗口;若命令面板不可用,则手动编辑 locale.json 文件为 {"locale":"zh-cn"} 并彻底重启 vs code。

安装 Microsoft 官方中文语言包插件
不装这个插件,后续所有操作都无效。VS Code 的界面汉化依赖于 Chinese (Simplified) Language Pack for Visual Studio Code,它由 Microsoft 官方维护,ID 是 MS-CEINTL.vscode-language-pack-zh-hans。
常见错误现象:搜 chinese 出一堆第三方插件,图标没蓝勾、作者不是 Microsoft —— 这些一律不点安装。
- 按
Ctrl+Shift+X打开扩展面板,输入小写chinese - 认准发布者为
Microsoft、名称含完整Chinese (Simplified) Language Pack for Visual Studio Code - 点击 Install,安装完成后右下角会弹出
Restart Now提示 —— 必须点它,不能只“重新加载窗口”
执行 Configure Display Language 命令选 zh-cn
插件只是资源包,真正激活中文界面靠的是这个命令。很多用户卡在这步,因为命令名里没有“中文”二字,纯靠英文缩写。
使用场景:命令面板能正常打开、VS Code 未卡死、设置界面可交互。
- 按
Ctrl+Shift+P调出命令面板 - 输入
Configure Display Language(注意大小写和空格,zh-CN、zh_CN、Chinese都无效) - 在下拉列表中严格选择
zh-cn(全小写 + 连字符) - 弹窗提示“需要重启窗口”,必须点
Restart,否则配置不加载
手动编辑 locale.json 强制生效
当命令面板打不开、选了 zh-cn 但重启后仍是英文、或批量部署时,直接改配置文件最可靠。它的优先级高于 UI 设置,且不依赖插件状态。
路径和格式稍有差异就失效,尤其要注意编码和 JSON 语法。
- 关闭所有 VS Code 窗口(Windows 要确认
Code.exe进程已退出) - 定位并编辑
locale.json:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容只能是标准 JSON:
{"locale":"zh-cn"}(无多余空格、逗号、BOM 头) - 保存后彻底重启 VS Code,不要只“重新加载窗口”
验证是否真汉化成功
别被局部英文骗了。终端输出、调试控制台、Git 日志、部分插件弹窗默认不走 locale 配置,显示英文 ≠ 汉化失败。
只盯这三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 左侧活动栏图标 hover 提示文字是否为中文
- 设置界面(
Ctrl+,)搜索框内输入locale,结果项显示值为"zh-cn"
如果菜单汉化不全(比如右键菜单仍是英文),那是官方汉化覆盖率问题(约 85%),可额外装 Chinese Menu 补全,但不属于核心步骤。











