VS Code汉化需安装官方中文语言包、执行Configure Display Language命令设locale为"zh-cn"并彻底重启三者缺一不可;必须认准全名、Microsoft发布者及正确路径配置,否则无效。

搜“中文插件”大概率装错,必须认准全名和发布者
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 默认仍用英文界面。必须手动告诉它“请用中文”,这步不能跳过,也不能靠设置界面里的旧选项。
操作路径很明确:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在弹出的 JSON 文件中,把
"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹,zh_CN或zh-hans都无效) - 保存后,必须点弹窗里的
Restart按钮,或手动关掉所有窗口 + 杀掉后台进程再重开
命令面板打不开或没反应?直接改 locale.json 最稳
如果 Configure Display Language 命令搜不到、空白、报错,说明语言包没真正装好,或者 VS Code 没读到配置路径。这时候别折腾命令面板,直接编辑配置文件更可靠。
步骤要严格:
- 彻底关闭所有 VS Code 窗口,包括托盘/后台进程(Windows 查任务管理器中
Code.exe,macOS 查Electron) - 用 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 - 写入内容:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码 - 重启 VS Code,界面立刻变中文
装完重启还显示英文?先查这三个地方
不是所有“已安装”都真的生效。常见失效原因集中在三个位置:
- 扩展面板里搜
@installed,确认Chinese (Simplified) Language Pack for Visual Studio Code状态是Installed,不是“Disabled”或灰色 - 检查有没有工作区级的
.vscode/locale.json—— 这个路径不生效,VS Code 只认用户级或系统级配置 - 排查环境变量干扰:终端里运行
echo $VSCODE_LANG(macOS/Linux)或echo %VSCODE_LANG%(Windows),如果输出en或其他值,需清除该变量
locale 配置只认 zh-cn 这一种写法,大小写、分隔符、空格、BOM 字节,任何一个细节错,就卡在英文界面不动。


















