VSCode界面语言切换本质是配置locale为"zh-cn",而非仅安装插件;必须执行Configure Display Language命令选zh-cn并彻底重启,插件仅提供翻译资源,locale配置才是生效关键。

VSCode界面语言切换本质是改locale配置,不是装插件就完事
装了“Chinese (Simplified) Language Pack”但界面还是英文?大概率是locale没生效。VSCode不自动读取系统语言,也不靠插件安装即切换——它只认locale.json或settings.json里明确写的"zh-cn"。插件只是提供翻译资源,真正触发切换的是这个配置值。
常见错误现象包括:插件已安装、右下角弹窗提示“重启”,但重启后仍是英文;或者命令面板搜Configure Display Language没反应——这说明语言包可能没装对,或 VSCode 版本太低(低于 1.80)不支持新版语言包机制。
- 务必安装微软官方插件:
Chinese (Simplified) Language Pack for Visual Studio Code(带蓝勾认证) - 安装后必须手动执行一次
Configure Display Language命令,选zh-cn,再点Restart - 如果命令面板里搜不到该命令,说明插件未正确加载,可尝试卸载重装,或检查 VSCode 是否为最新版(
Help → Check for Updates)
两种可靠方式设置locale:命令面板 vs 手动改配置文件
推荐优先用命令面板,操作直观且不易出错;手动改配置文件适合批量部署或脚本化管理。
用命令面板的方式:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac)打开命令面板 - 输入
Configure Display Language,回车 - 在弹出列表中选择
zh-cn,然后点击Restart按钮(不是关闭窗口再手动打开)
手动改配置文件的方式(当命令面板失效时备用):
- 打开命令面板,运行
Preferences: Open Settings (JSON) - 在
settings.json中添加一行:"locale": "zh-cn"(注意加逗号,不要破坏 JSON 格式) - 保存后仍需重启 VSCode,否则不生效
- 极少数情况(如远程开发或企业策略锁死),VSCode 会忽略
settings.json中的locale,此时要改用户级locale.json:菜单栏Help → Show Developer Tools→ 控制台输process.env.VSCODE_PORTABLE看路径,然后去~/.vscode/或%USERPROFILE%\AppData\Roaming\Code\User\下找并编辑locale.json,确保内容为{"locale":"zh-cn"}
为什么终端、调试控制台、错误提示还是英文?这不是locale能管的
VSCode 的 locale 只控制编辑器外壳(菜单、设置面板、命令面板、侧边栏等),不影响以下三类内容:
-
Integrated Terminal输出:它调用的是系统 shell(如 PowerShell、bash),其语言由操作系统区域设置或 shell 自身环境变量(如LANG=zh_CN.UTF-8)决定,和 VSCode 无关 - 语言服务器输出(如 Python 的 Pylint、C++ 的 clangd):这些是独立进程,是否中文取决于插件本身是否实现本地化,例如官方 Python 插件目前不提供中文诊断信息
- 编译器/运行时错误(如
gcc、node报错):完全由工具链决定,VSCode 不做翻译
所以看到调试窗口里一堆英文报错,不是汉化失败,而是正常行为。想让终端显示中文,得单独配系统 locale 或 shell 启动脚本;想让某些插件提示变中文,得看它有没有提供对应语言包(比如部分 Java 插件支持 java.configuration.runtimes 配置中文提示)。
多语言自由切换的关键:别硬编码,用配置开关+快捷键
如果你常要看英文文档、查英文报错,又不想每次进设置改来改去,可以设一个“中英秒切”机制:
- 在
settings.json里写:"locale": "zh-cn"(默认中文) - 再装一个轻量插件如
Toggle Locale,它能在状态栏加个切换按钮,点一下就切到en,再点切回zh-cn - 或者自定义快捷键:打开
keybindings.json,加一条:{"key": "ctrl+alt+l", "command": "configureDisplayLanguage", "args": {"locale": "en"}},另一条对应zh-cn
注意:切换后仍需重启 VSCode 才能生效,目前没有热重载界面语言的 API。这点容易被忽略——很多人点了切换、没重启,以为功能坏了。


















