vscode中文界面需三步缺一不可:安装microsoft官方简体中文语言包、执行configure display language命令选zh-cn、完全退出后重启。常见失败原因是未装语言包,仅改配置无效。

VSCode 没有真正意义上的“一键设置中文”——所谓“一键”,其实是三步操作压缩成一次命令调用,但必须装好语言包、触发配置、重启生效,缺一不可。
为什么 Ctrl+Shift+P 输入 Configure Display Language 后选了 zh-cn 却没变中文
最常见原因是:语言包根本没装。VSCode 的 Configure Display Language 命令只是改配置,它不负责下载翻译资源。如果扩展市场里没装过 Chinese (Simplified) Language Pack,选完 zh-cn 重启后界面依然英文,控制台甚至不会报错,只是默默加载失败。
- 先打开扩展面板(
Ctrl+Shift+X),搜Chinese,认准发布者是Microsoft,安装那个带 “(Simplified)” 字样的官方包 - 装完别急着关,直接按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn→ 点Restart - 如果重启后还是英文,检查
%USERPROFILE%\AppData\Roaming\Code\User\locale.json(Windows)或~/Library/Application Support/Code/User/locale.json(macOS)里是否真写了"locale": "zh-cn"
locale.json 文件手动改比命令面板更可靠吗
手动改确实绕过命令面板的潜在缓存或 UI 延迟问题,但风险在于路径和格式容错低。VSCode 会优先读这个文件,但写错一个逗号或引号就可能导致启动失败或回退到英文。
- 文件路径必须准确:Windows 是
%APPDATA%\Code\User\locale.json,macOS 是~/Library/Application Support/Code/User/locale.json,Linux 是~/.config/Code/User/locale.json - 内容只能是标准 JSON:
{"locale":"zh-cn"},不能多空格、不能加注释、不能漏大括号 - 改完必须完全退出 VSCode 进程(任务管理器里确认
Code.exe或Electron进程已结束),再双击图标启动,否则旧进程可能复用缓存
远程开发(SSH / WSL)下中文界面不生效怎么办
远程窗口用的是远端 VSCode Server 的语言包,和本地安装的语言包无关。你在本地装了中文包,对 SSH 连接进来的窗口毫无作用。
- 在远程环境(比如 Ubuntu WSL 或 Linux 服务器)里,也得单独运行 VSCode 客户端,然后同样走一遍:装官方中文语言包 →
Configure Display Language→ 重启远程窗口 - 或者直接在远程终端执行:
code --locale=zh-cn,强制本次启动用中文(临时生效,不改配置) - 注意:远程环境若无图形界面或字体缺失,可能出现中文方块或乱码,需额外装中文字体(如
fonts-wqy-zenhei)
最容易被忽略的点是:语言包和界面语言是两层东西。装了包不等于启用了,启用了不等于远端也同步了,同步了不等于字体能正常渲染。每一步断在哪,现象都一样——还是英文,但原因完全不同。











