vs code 中文界面需完成安装官方语言包、执行 configure display language 命令并彻底重启三步,缺一不可;仅靠插件安装或重新加载窗口无效。

VS Code 中文界面不是装完插件就自动生效的,必须完成「安装语言包 + 执行切换命令 + 重启」三步闭环,缺一不可。装错插件、跳过命令、只“重新加载窗口”不退出进程,都会导致界面仍是英文。
怎么确认装的是 Microsoft 官方中文语言包
在扩展面板(Ctrl+Shift+X)搜 Chinese (Simplified) Language Pack for Visual Studio Code,只认发布者为 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那个。其他名字带“汉化”“中文支持”“VSCode Chinese”的第三方插件一律不碰——它们不更新、不兼容新版、甚至可能注入异常脚本。
常见错误现象:Configure Display Language 命令在命令面板里搜不到,基本就是装错了插件或根本没装成功。
网络受限时可离线安装:
下载 vscode-language-pack-zh-hans.vsix 后,在命令行执行:code --install-extension vscode-language-pack-zh-hans.vsix
为什么装完插件还是英文?关键在 Configure Display Language
语言包只是“备好了翻译字典”,VS Code 默认仍用英文启动。真正切换语言靠的是内置命令 Configure Display Language,不是设置里点几下就能改的。
操作路径:Ctrl+Shift+P → 输入 Configure Display Language → 回车 → 选 zh-cn(注意是小写、连字符,不是 zh_CN 或 Chinese)→ 点“是”重启窗口。
容易踩的坑:
• 命令名不含“中文”二字,纯靠拼音缩写,新手常搜 change language 或 chinese 找不到
• 选错选项后,settings.json 里可能被写成 "locale": "zh" 这类无效值,后续再选也无效
• 点了“重新加载窗口”但没彻底退出进程(Windows 任务管理器里仍有 Code.exe),配置不加载
settings.json 手动加 locale 失效?检查这三点
当命令面板打不开、或执行了命令但重启后仍是英文,直接改配置文件最稳,但有三个硬性条件:
• 打开的是用户级 settings.json(用 Ctrl+Shift+P → Open User Settings (JSON),别去改工作区或默认设置)
• 文件编码必须是 UTF-8 无 BOM,否则中文乱码或整行配置被忽略
• 只加一行:"locale": "zh-cn",已有该字段就只改值,不要重复写 key
macOS 路径:$HOME/Library/Application Support/Code/User/settings.json
Linux 路径:$HOME/.config/Code/User/settings.json
验证中文是否真生效,别被假象骗了
终端输出、调试控制台、Git 提示、部分插件弹窗天生不走 locale 配置,显示英文 ≠ 汉化失败。只盯以下三处:
• 顶部菜单栏:文件、编辑、视图、终端、帮助是否为中文
• 命令面板(Ctrl+Shift+P)输入框上方提示是否为“请输入命令或搜索设置”
• 设置界面(Ctrl+,)左侧分类标签:“用户”“工作区”“扩展”是否中文
如果这三处全是中文,说明汉化已到位;其他地方英文,属于正常行为,不用折腾。











