必须安装microsoft官方中文语言包(全名chinese (simplified) language pack for visual studio code,id为ms-ceintl.vscode-language-pack-zh-hans),执行configure display language命令设locale为"zh-cn"并彻底重启,三者缺一不可。

装错插件:搜“中文”就出问题
VS Code 的简体中文支持只来自一个插件:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文”“汉化”“简体中文”等关键词,出来的大多是第三方仿冒包——图标模糊、描述带广告、下载量低、更新停滞。装了也不生效,还可能干扰后续配置。
正确做法只有这一种:
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 在搜索框里**严格粘贴全名**:
Chinese (Simplified) Language Pack for Visual Studio Code - 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项,确认发布者是
Microsoft - 点击
Install,别信右下角弹出的 “Reload Window” 提示——它不切换语言
Configure Display Language 命令找不到?说明没装对或没重启
语言包只是“备好了翻译字典”,VS Code 默认仍用英文界面。必须手动告诉它“请用中文”,这步不能跳过,也不能靠设置界面里的旧选项。
常见错误现象:
- 命令面板里搜不到
Configure Display Language→ 语言包根本没装成功,或安装后没彻底重启 - 搜到了但选完
zh-cn后界面仍是英文 →locale.json路径不对,或文件编码不是 UTF-8 无 BOM - 点了 “Reload Window” 就以为完成 → 这个操作只刷新 UI,不重载语言环境,必须关掉所有窗口再重开
执行路径很明确:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在弹出的 JSON 文件中,把
"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹,zh_CN或zh-hans都无效) - 保存后,点弹窗里的
Restart按钮,或手动关掉所有窗口 + 杀掉后台进程再重开
手动改 locale.json 最稳,但路径和编码不能错
如果命令面板打不开、空白、报错,别折腾,直接编辑配置文件更可靠。VS Code 只读取用户级 locale.json,其他路径写的配置无效。
不同系统路径不同:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json - 便携版:
[安装目录]/data/user-data/User/locale.json
关键细节:
- 如果多个路径下都有
locale.json,删掉非用户级的,避免覆盖 - 文件内容应为纯 JSON:
{"locale": "zh-cn"},不要多加逗号或换行 - 文件编码必须是 UTF-8 无 BOM,否则中文乱码或配置不解析
- 改完必须彻底退出 VS Code:Windows 查任务管理器中
Code.exe,macOS 查活动监视器中Electron进程是否清空
验证时只盯三个地方,别被局部英文骗了
终端、调试控制台、Git 输出、部分插件弹窗天生不走 locale 配置,显示英文 ≠ 汉化失败。
只盯以下三处:
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示中文提示 - 设置界面:
Ctrl+,打开后,左侧导航栏是否为中文(如“通用”“编辑器”“工作台”)
真正容易被忽略的是:改完配置不彻底退出进程,或以为“重载窗口”就够了——它只刷新编辑器 UI,不重载语言环境。必须关干净再重开,否则永远卡在英文。











