必须安装Microsoft官方中文语言包、执行Configure Display Language命令选zh-cn、并彻底重启VS Code,三者缺一不可;装错插件、选错locale值或仅重载窗口均会导致界面仍为英文。

装对插件、设对 locale、彻底重启——三者缺一不可,少一个都会卡在英文界面。
安装 Microsoft 官方中文语言包(别搜“汉化”)
VS Code 的中文支持只认一个扩展:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X打开扩展面板,搜全名,不搜“中文”“汉化”——那些结果大概率是失效或带风险的第三方插件 - 安装后右下角必须点 Restart Now;如果没弹提示,说明安装失败(常见于 VS Code 版本低于 1.13,需先升级)
- 装完但命令面板仍空白、搜索框输不了中文,基本是装了错误插件破坏了 locale 读取逻辑
执行 Configure Display Language 命令并选 zh-cn
语言包只是“字典”,Configure Display Language 才是激活开关。这个命令会写入 locale.json,但只写不生效,必须配合重启。
- 按
Ctrl+Shift+P输入Configure Display Language并执行 - 列表里只认
zh-cn(全小写、连字符),zh_CN、ZH-CN、zh-hans全部无效,且不会报错,只会静默维持英文 - 选完后弹出的 Restart 提示,必须点;用
Developer: Reload Window是无效的——它不重载语言资源
手动编辑 locale.json(命令面板失效时的兜底方案)
当命令面板打不开、切换后无反应,或公司内网无法访问扩展市场时,直接改文件最稳。
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 运行pkill -f "Electron.*Code";Linux 运行pkill -f "code.*--no-sandbox" - 打开对应路径的
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 自己打开编辑,右下角状态栏确认显示 UTF-8)
真正容易被忽略的是:locale.json 必须放在用户级路径下,且不能和 settings.json 混用——后者从 VS Code 1.70 起已移除 locale 字段支持;另外终端、调试控制台、部分插件 WebView 页面的语言是独立控制的,它们显示英文 ≠ 主界面汉化失败。


















