VS Code 切换中文界面需同时满足三条件:安装微软官方中文语言包(ID ms-ceintl.vscode-language-pack-zh-hans)、执行 Configure Display Language 命令将 locale.json 中 "locale" 设为 "zh-cn"、彻底重启进程(非仅 Reload Window)。

VS Code 装完默认是英文界面,不是没汉化成功,而是根本还没告诉它“请用中文”。只要装对插件、设对语言、重启干净,三步就能切中文,不需要重装或改一堆配置。
怎么装对中文语言包(认准官方 ID)
搜“中文插件”容易装错——第三方名字相似的插件(比如 Chinese Language Pack 或 VSCode Chinese)不维护、不更新、甚至可能带广告。唯一可靠的是微软官方语言包:
- 扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans,发布者必须是Microsoft - 在扩展面板(
Ctrl+Shift+X)里搜Chinese (Simplified) Language Pack for Visual Studio Code,只点这个 - 安装后右下角会弹提示“Restart Now”,**必须点它**;如果没弹,说明没触发语言切换逻辑
为什么装了还是英文?关键在 locale 设置
语言包只是“字典”,locale 才是“开关”。VS Code 不会自动启用刚装的语言包,必须显式指定:
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language并执行 - 从列表中选
zh-cn(注意:小写、连字符,zh_CN或zh-CN都无效) - 弹窗提示“Restart”,点击后**所有 VS Code 窗口必须完全关闭**(Windows 检查任务管理器里有没有残留的
Code.exe) - 再打开,界面立刻变中文;如果仍无效,直接编辑
locale.json文件(路径见下方)
locale.json 手动设置(绕过 UI 失效场景)
当命令面板打不开、切换失败或公司内网无法访问扩展市场时,这是最稳的兜底方式:
- 先彻底退出 VS Code(包括后台进程)
- 找到用户配置目录:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 用 VS Code 自己新建或编辑该文件,内容仅一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM - 重新启动 VS Code,无需安装插件也能生效(但长期使用仍建议装上官方语言包)
终端和调试面板还是英文?这不是 bug
VS Code 的终端(Terminal)、调试控制台(Debug Console)、部分扩展界面默认不走主 locale 设置,属于已知限制:
- 终端本身是系统 shell(如 PowerShell、bash),语言取决于系统区域设置,VS Code 不干预
- 调试面板显示的变量名、报错堆栈等来自运行时(Node.js、Python 解释器等),由对应语言环境决定
- 想让调试日志更易读,可在 launch.json 中加环境变量,例如:
"env": {"LANG": "zh_CN.UTF-8"}(Linux/macOS) - 第三方插件(如
Chinese Menu)能补全右键菜单汉化,但核心界面已足够完整
真正容易被忽略的是:重启必须彻底——哪怕只剩一个隐藏窗口,locale 就不会刷新;还有就是 zh-cn 的拼写,大小写和符号错一个,整个设置就静默失效。


















