VSCode界面语言仅由用户级locale.json控制,工作区级设置无效;必须手动编辑对应系统路径下的locale.json文件,内容为{"locale":"zh-cn"},且需安装Microsoft官方中文语言包,远程开发环境还需单独配置。

用户级 locale 配置才是唯一生效位置
VSCode 的界面语言由 locale 字段控制,但它**只在用户级配置中起作用**,工作区级(即项目目录下的 .vscode/settings.json)写 locale 完全无效。这是很多人反复修改却没反应的根本原因。
必须编辑的文件路径是:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
内容只能是标准 JSON 格式的一行:{"locale":"zh-cn"}。注意:zh-cn 必须小写、带短横、不能写成 zh_CN、zh-hans 或 Chinese——错一个字符就 fallback 到英文。
Configure Display Language 命令已弃用(1.80+ 版本)
如果你用的是 VSCode 1.80 或更高版本(2026 年绝大多数用户已是),Ctrl+Shift+P 输入 Configure Display Language 将不再出现或直接报错。这个命令在新版中已被移除,依赖它设置语言会失败。
替代方案只有手动编辑 locale.json 文件:
- 确保 VSCode 已完全退出(检查任务管理器 / 活动监视器里没有
Code进程) - 新建或覆盖
locale.json,内容严格为{"locale":"zh-cn"} - 重启 VSCode,弹出「重新加载窗口」提示时,务必点
Reload Window,不是关掉再开
中文语言包必须已安装,否则 locale 设置无意义
locale 只是开关,真正提供翻译的是 Chinese (Simplified) Language Pack for Visual Studio Code 扩展。它必须由 Microsoft 发布(ID:ms-ceintl.vscode-language-pack-zh-hans),第三方“汉化插件”会导致命令面板乱码或部分 UI 不翻译。
验证是否装对:
- 按
Ctrl+Shift+X打开扩展面板 - 搜索
Chinese (Simplified) Language Pack,确认发布者是Microsoft - 状态应为「已启用」,图标不灰
如果扩展被禁用,或安装后没重启,locale.json 再正确也显示英文。
远程开发(SSH/WSL)需单独配置
VSCode 的语言设置不跨环境:本地窗口的语言配置不影响 Remote-SSH 或 WSL 窗口。你在本地设了 zh-cn,远程窗口仍默认英文。
必须在远程环境中重复以下操作:
- 打开远程窗口后,在扩展面板中搜索并安装同款中文语言包(它会装到远程机器的
~/.vscode-server/extensions/) - 编辑远程端的
locale.json(路径与本地一致,但位于远程系统上) - 执行
Developer: Reload Window或重启远程窗口
最容易被忽略的是:远程环境里没装语言包,只改了 locale.json,结果所有菜单、设置页仍是英文——这不是 bug,是设计如此。











