vscode中文界面需同时安装微软官方语言包ms-ceintl.vscode-language-pack-zh-hans、执行configure display language命令设locale为"zh-cn"、并彻底重启所有进程;缺一不可,仅装插件或仅重载窗口无效。

必须装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans,执行 Configure Display Language 命令选 zh-cn,并彻底退出所有进程再重启——三者缺一不可。搜“中文插件”“汉化包”大概率装错,界面仍英文就是这三步里至少漏了一环。
怎么确认装的是官方中文语言包
VS Code 不认“中文”“汉化”这类模糊关键词,只认一个扩展:全名 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 必须是 ms-ceintl.vscode-language-pack-zh-hans。
- 在扩展面板(
Ctrl+Shift+X)中,**严格粘贴全名搜索**,不要简写、不要换词 - 图标必须是蓝白 VS Code logo + 中文“中”字,右下角带 Microsoft 徽章
- 名字含“Chinese Menu”“VSCode Chinese”“汉化补丁”的第三方插件一律跳过——它们不翻译设置页、命令面板仍是英文,还可能覆盖提示文案导致乱码
- 装完右下角弹窗若提示“Reload window”,别点它;这个操作不触发语言切换
Configure Display Language 命令找不到或无效
这个命令不是可有可无的附加项,它是把 {"locale":"zh-cn"} 写入 locale.json 的唯一可靠入口。搜不到或点了没反应,基本说明语言包根本没加载成功。
- 先验证:按
Ctrl+Shift+P输入Extensions: Show Installed Extensions,确认ms-ceintl.vscode-language-pack-zh-hans在列表中且状态为 Enabled - 若不在列表,重装;若在但禁用,手动启用
- 若命令面板能搜到但选了
zh-cn后仍是英文,大概率是点了 “Reload Window” 而非 “Restart” —— 后者才会清空语言运行时上下文 - 执行后弹出的确认框必须点 “Restart”,不能手动关再开,否则可能复用旧进程缓存
手动编辑 locale.json 强制生效
当命令面板卡死、UI 崩溃、或批量部署时,直接改配置文件最稳。VS Code 1.70+ 版本只读用户级 locale.json,settings.json 里的 "locale": "zh-cn" 已完全失效。
- 路径必须准确:
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、无逗号结尾、双引号必须是英文符号) - 常见错误写法:
"locale": "zh_CN"(下划线)、"locale": "zh-hans"(VS Code 当前不识别)、"locale": "Chinese"(非标准标识符)——全都不生效,且无任何报错提示 - 改完必须彻底关闭所有 VS Code 进程(Windows 查任务管理器中的
Code.exe,macOS 查活动监视器里的Electron),再全新启动
最容易被忽略的是进程残留:哪怕只留一个托盘图标或后台 Code Helper 进程,新窗口就会继承旧 locale 环境,中文永远不出现。关窗口 ≠ 关进程,这点必须亲手确认。











