vscode显示中文界面必须同时安装microsoft官方中文语言包并设置locale为"zh-cn";装错第三方插件、写错locale格式(如zh_cn、zh-cn)或仅重载窗口均无效,必须彻底重启。

VSCode 要真正显示中文界面,必须同时满足两个硬性条件:装对官方语言包 + 显式设置 locale 为 zh-cn;只装插件不设 locale,或设了但写成 zh_CN/zh-CN,都会静默失败,界面照旧英文。
安装 Microsoft 官方中文语言包(认准 ID 和作者)
第三方“汉化插件”名字相似但不可信,它们不更新、不覆盖核心 UI 文字、甚至会干扰 locale 读取。唯一有效的是微软官方包:
- 扩展名必须是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 在扩展面板(
Ctrl+Shift+X)搜chinese(小写),只点这个带蓝勾的条目 - 安装后右下角弹出
Restart Now提示——必须点它,仅“重载窗口”无效
执行 Configure Display Language 命令(zh-cn 是唯一合法值)
这个命令才是触发语言切换的开关,不是装完就自动生效。它不接受任何变体写法:
- 快捷键
Ctrl+Shift+P→ 输入Configure Display Language→ 回车 - 下拉列表里只认
zh-cn(全小写、连字符),zh_CN、ZH-CN、Chinese都不会生效 - 选中后弹出“是否重启窗口”,必须点
Restart,不能点Reload Window - 如果命令面板里根本没这个选项,说明语言包压根没装成功,或没完成重启
手动编辑 locale.json(兜底方案,路径和格式零容错)
当命令面板打不开、切换失败或内网无法访问扩展市场时,直接写死配置最可靠。但它对路径、文件名、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"} - 不能有注释、空行、中文引号、BOM 头、多余逗号,也不能放在工作区
.vscode/目录下 - 改完必须彻底退出 VS Code(Windows 查任务管理器杀光
Code.exe,macOS 看活动监视器),再重新启动
终端和调试控制台仍是英文?这不是配置问题
这部分界面默认不走 VS Code 的 locale 设置,属于已知限制,和汉化是否成功无关:
- 终端(Terminal)用的是系统 shell(如 PowerShell、bash),语言取决于系统区域设置,VS Code 不干预
- 调试控制台(Debug Console)显示的变量名、报错堆栈来自运行时(Node.js、Python 解释器等),由对应语言环境决定
- 想让调试日志更易读,可在
launch.json中加环境变量,例如:"env": {"LANG": "zh_CN.UTF-8"}(仅 Linux/macOS 有效) - 部分第三方插件界面未汉化,是插件自身没提供翻译,非 VS Code 设置可解决
最容易被忽略的是:装完语言包后右下角弹出的“Change Language and Restart”按钮,只改当前窗口语言,新打开的窗口可能回退成英文——必须通过 Configure Display Language 全局设置,或确保 locale.json 存在且格式绝对正确。











