VSCode界面中文化必须同时满足安装Microsoft官方中文语言包、手动配置locale.json为{"locale":"zh-cn"}、彻底关闭所有进程后重启三者,缺一不可;第三方插件、错误locale值或未彻底重启均会导致汉化失败。

VSCode 界面中文化不是装个插件就完事,必须同时满足三个条件:装对插件、设对 locale 值、彻底重启进程;漏掉任一环,菜单栏、设置页、命令面板都会卡在英文。
怎么找对中文语言包?只认 Microsoft 官方 ID
搜“中文插件”“汉化包”大概率装错——第三方扩展可能乱码、带广告,甚至劫持主页。正确做法是:
- 按
Ctrl+Shift+X打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 点击 Install;安装完别点右上角的 “Reload”,它不触发界面刷新
如果搜不到,说明 VS Code 版本低于 1.13,需先升级。VS Code 1.118(2026年6月发布)已全面兼容该语言包,无需额外适配。
Configure Display Language 命令为什么没反应?
这个命令本质就是编辑 locale.json 文件。若命令面板打不开、输入后无响应、或列表里没有 zh-cn,直接改配置文件更可靠:
立即学习“前端免费学习笔记(深入)”;
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。
- 关掉所有 VS Code 窗口,包括托盘进程(Windows 查任务管理器中
Code.exe,macOS 查Electron) - 用文本编辑器打开对应路径下的
locale.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"}(注意:小写、连字符、无空格、UTF-8 无 BOM)
别写成 zh_CN、zh-hans、Chinese 或 zh——这些全无效。
为什么终端、右键菜单、Git 提示还是英文?
这是正常现象,不是汉化失败:
- 终端(Terminal)、调试控制台(Debug Console)、部分插件弹窗(如 Live Server 的通知)天生不走 VS Code 的
locale配置 - 右键菜单和 Git 相关提示属于底层 Shell 或 Git 自身行为,微软未翻译这部分
- 官方汉化覆盖率约 85%,重点保障顶部菜单栏、命令面板(
Ctrl+Shift+P)、设置界面(Ctrl+,)三处
验证时只盯这三处:菜单栏是否显示「文件」「编辑」「视图」;命令面板上方是否提示「请输入命令或搜索设置」;设置左侧导航是否为「用户」「工作区」「扩展」。其他区域英文不用折腾。
最容易被忽略的是:插件安装后没点 Restart Now、命令输错成 Configure Language、locale 值写成大写或带下划线——这三个细节出错,90% 的“汉化失败”就发生了。

















