VS Code 中文界面需安装微软官方语言包、正确配置 locale.json 并彻底终止所有进程后重启。必须使用 ID 为 ms-ceintl.vscode-language-pack-zh-hans 的插件,locale.json 内容严格为 {"locale":"zh-cn"}(UTF-8 无 BOM),且仅生效于用户级路径;settings.json 中设置 locale 已失效。

VS Code 界面不会自动变中文,必须装对包、设对值、杀干净进程——三者缺一不可。装第三方“汉化插件”或只点“重新加载窗口”,90% 的失败都出在这两步。
怎么确认装的是微软官方中文语言包
在扩展面板(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 命令在命令面板里搜不到,基本就是语言包根本没装上,或者装了但发布者不是 Microsoft。
为什么装完还是英文?关键在 locale.json 和彻底重启
Configure Display Language 命令本质是写入并打开 locale.json 文件。如果点了“重启”但界面仍是英文,大概率是旧进程还在后台跑,新窗口复用了旧环境。
- Windows:任务管理器中结束所有
Code.exe进程(包括“后台服务”) - macOS:终端执行
pkill -f "Electron.*Code",或活动监视器里查Electron - Linux:运行
pkill -f "code.*--no-sandbox"
locale.json 路径必须准确,内容必须严格:
{"locale":"zh-cn"}
注意:小写、连字符、无空格、无 BOM、UTF-8 编码、仅此一行。写成 zh_CN、zh-hans、Chinese 或漏引号,VS Code 都会静默回退到英文。
settings.json 里加 locale 失效?那是版本过时了
VS Code 1.70+ 已彻底弃用在 settings.json 中设置 "locale": "zh-cn" 的方式。现在只读独立的 locale.json,且只认用户级路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
如果你手动创建了 locale.json 但没生效,先确认文件编码是否为 UTF-8 无 BOM;再检查 VS Code 是否真的已完全退出——右下角状态栏仍显示 en 就说明没杀干净。
菜单/插件/终端还有英文?不是设置错了,是它们本来就不走 locale
VS Code 本体 UI(顶部菜单、侧边栏、设置面板标题、命令面板提示)能完全汉化,但以下情况显示英文属正常:
- 终端(
Integrated Terminal)输出、Git 提示、调试控制台日志——它们由系统 shell 或运行时决定,和locale.json无关 - 第三方插件(如
Python、Prettier、GitLens)的按钮、弹窗、侧边栏标题——取决于插件自身是否提供中文语言包 - WebView 类插件(如
Copilot Chat)——语言由远程服务返回,本地 locale 不影响
真正容易被忽略的,是“以为点了 Restart Now 就算重启成功”。实际必须确保所有 Code.exe / Electron 进程消失,再手动双击图标启动——这才是唯一可靠的操作闭环。


















