vscode 中文界面需同时满足三条件:安装 microsoft 官方简体中文语言包、通过 configure display language 命令准确设置 zh-cn、彻底重启进程;手动改 locale.json 仅用于远程开发等特殊情况,且必须为 utf-8 无 bom 编码。

VSCode 要显示中文界面,只靠“装个中文插件”或“点一下设置”是不够的——必须同时满足三个硬性条件:装对插件、选对语言值、彻底重启。缺一不可,否则大概率卡在英文或乱码。
安装 Microsoft 官方中文语言包(不是随便搜“中文”)
第三方插件(比如叫 Chinese Language Pack、VSCode Chinese 或带 Pro 字样的)不维护、不兼容,装了反而会触发 Cannot read property 'translate' of undefined 报错,甚至让命令面板输入框变乱码。
- 按
Ctrl+Shift+X打开扩展面板,搜索Chinese (Simplified) Language Pack for Visual Studio Code - 认准发布者是
Microsoft,带蓝勾认证图标,扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans - 点击 Install,右下角弹出
Restart Now提示时——必须点它,不能只“重新加载窗口”
用 Configure Display Language 命令选 zh-cn(大小写和符号都不能错)
插件只是“备好了字典”,真正告诉 VS Code “请用简体中文”的唯一入口是 Configure Display Language 命令。它会自动生成或更新 locale.json,手动改 settings.json 在 VS Code 1.70+ 已完全失效。
- 按
Ctrl+Shift+P呼出命令面板,完整输入Configure Display Language(注意大小写和空格) - 从下拉列表中**明确选择**
zh-cn——ZH-CN、zh_CN、zh-CN、Chinese全部无效,且无任何错误提示 - 弹窗提示“是否重启窗口”,必须点
Yes;这一步才真正写入配置并触发新进程读取
手动编辑 locale.json(命令面板打不开或切换后仍无效时)
远程开发(Remote-SSH / WSL)下中文不生效,往往是因为 VS Code Server 读的是远程机器上的 locale.json,而非本地路径。此时直接改文件最稳,绕过 UI 层。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe进程;macOS 在活动监视器里结束Code Helper - 打开对应路径的
locale.json:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只写一行标准 JSON:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码,不能多空格、多逗号、多引号
验证是否真汉化成功(别被局部英文骗了)
终端输出、调试控制台、Git 日志、部分插件弹窗默认不走 locale 配置,显示英文 ≠ 汉化失败。真正该盯的只有三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 左侧活动栏图标 hover 提示文字是否为中文
- 设置界面(
Ctrl+,)搜索locale,结果项显示值为"zh-cn"
最容易被忽略的是:远程开发实例、集成终端、调试器界面的语言是各自独立控制的,它们不继承 VS Code 主界面的 locale 设置。看到终端还是英文?不是配置错了,是正常现象。











