vs code 界面语言切换必须安装官方语言包、执行 configure display language 命令并重启窗口,三者缺一不可;settings.json 中的 "locale" 已被弃用,仅 locale.json(用户级目录下)生效。

VS Code 编辑器界面语言切换必须安装对应语言包 + 执行 Configure Display Language 命令 + 重启窗口,三者缺一不可;直接改 settings.json 无效,且 locale.json 必须位于用户级配置目录才生效。
为什么装了中文语言包还是英文界面
常见错误是只装插件、没触发语言激活。VS Code 1.70+ 版本起已完全弃用 settings.json 中的 "locale": "zh-cn" 配置项——它会被静默忽略,不报错也不生效。真正起作用的是独立的 locale.json 文件,且只能由 VS Code 自己生成或通过命令写入。
- 搜索扩展时输错名:必须输入完整名称
Chinese (Simplified) Language Pack for Visual Studio Code,认准作者是Microsoft,别选Chinese Language Pack或其他非官方包 - 装完没执行命令:插件只是“备好翻译资源”,
Configure Display Language才是“打开开关”的动作 - 点了 Reload Window 却没反应:可能
locale.json被写到了当前工作区(.vscode/locale.json),而用户级路径才是生效位置(如%APPDATA%\Code\User\locale.json或~/.config/Code/User/locale.json)
如何用命令面板正确切换中/英文
这是最稳、最通用的方式,跨 Windows/macOS/Linux 一致有效,且自动处理语言包缺失跳转和文件写入逻辑。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,回车 - 从列表中选
zh-cn(切中文)或en(切英文),注意大小写和连字符格式:不是zh_CN、zh-CN、Chinese - 若提示“语言包未安装”,点
Install;安装完成后会自动打开locale.json并填好"locale": "zh-cn" - 点击右下角弹出的
Reload Window(不是关掉重开,也不是Ctrl+R刷新)
locale.json 手动编辑的注意事项
虽然不推荐新手手动改,但排查问题或离线部署时可能需要。关键点不在内容,而在位置和编码:
- 文件必须放在用户级目录:
%APPDATA%\Code\User\locale.json(Windows)、~/.config/Code/User/locale.json(Linux)、~/Library/Application Support/Code/User/locale.json(macOS) - 内容仅需一行有效 JSON:
{"locale":"zh-cn"},不要加注释、不要带 BOM 头 - 远程开发(WSL / SSH)需单独配置:本地
locale.json不影响远程窗口,得在远程环境中重复执行Configure Display Language - 终端启动的干扰:在 Linux/macOS 终端中运行
code .时,若环境变量$LANG或$LC_ALL设为en_US.UTF-8等,会强行覆盖locale.json设置
最容易被忽略的是:状态栏右下角显示的语言代码(如 en 或 zh-cn)就是当前实际生效的 locale,点它可快速验证或切换;部分第三方扩展界面仍为英文,不是设置失败,而是那些扩展本身没提供中文翻译资源。











