VSCode中文界面需安装官方语言包ms-ceintl.vscode-language-pack-zh-hans并手动配置locale为"zh-cn",否则仅装包无效;离线时直接编辑locale.json文件,多用户环境易因配置丢失回退英文。

VSCode中文语言包必须认准官方扩展ID
VSCode没有“插件管理插件”的中文版,所谓“中文版”实际是指整个编辑器界面的本地化——它依赖的是官方语言包 ms-ceintl.vscode-language-pack-zh-hans,不是某个独立插件的翻译。搜“中文插件”“汉化插件”大概率装错,比如 Chinese Language Pack 或 VSCode Chinese 这类非官方扩展,装了也不生效,甚至干扰更新。
正确做法只有一条路径:在扩展面板里严格输入全名 Chinese (Simplified) Language Pack for Visual Studio Code,认准发布者是 Microsoft、图标带蓝白 VS 标志和红色“中”字。其他任何名称都不要点。
装完还是英文?关键在 locale 配置
语言包只是“备好了翻译字典”,VSCode 默认仍用英文界面。必须显式设置语言为 zh-cn 才能生效,大小写、连字符、引号一个都不能错。
- 按
Ctrl+Shift+P打开命令面板,输入并执行Configure Display Language - 在弹出的
locale.json文件中,把"locale": "en"改成"locale": "zh-cn"(注意:不是zh_CN、zh-hans或zh) - 保存后必须点击弹窗里的
Restart按钮,或手动关掉所有窗口 + 杀掉后台进程(Windows 任务管理器查Code.exe,macOS 查Electron)再重开
离线或命令行场景下直接改 locale.json 最稳
公司内网、教育网或命令面板打不开时,跳过 UI 层直接编辑配置文件是唯一可靠方式。
关闭所有 VSCode 窗口后,用 VSCode 自己打开对应路径下的 locale.json:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容只写一行:{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码。重启即生效。
多用户或重装后界面回退到英文,通常不是插件问题
插件装了,但 locale.json 被覆盖或丢失,VSCode 就会静默回退到英文,且没有任何报错提示。这种问题在跨平台同步、重装系统、或使用 Snap 安装的 Linux 版本时特别常见。
此时加启动参数临时启用中文可验证是否是配置问题:code --locale=zh-cn。如果生效,说明只是 locale.json 没配对,而不是语言包没装好。
真正麻烦的是企业环境里,管理员锁死了用户数据目录,或者 VSCode 启动时绕过了个人配置——这时候得靠 --locale 参数或联系 IT 部门调整策略。


















