VS Code汉化需同时满足三条件:安装Microsoft官方中文语言包(ID ms-ceintl.vscode-language-pack-zh-hans)、执行Configure Display Language命令将locale设为"zh-cn"、彻底重启进程;缺一不可。

安装 Chinese (Simplified) Language Pack 扩展必须认准 Microsoft 官方发布者
VS Code 不会自动汉化,语言包只是资源容器,不是“一键汉化”插件。装错扩展(比如搜“中文插件”“汉化包”点进第三方)会导致命令面板乱码、设置项不翻译,甚至覆盖默认提示文案。
- 按
Ctrl+Shift+X打开扩展面板,搜索完整名称:Chinese (Simplified) Language Pack for Visual Studio Code - 只安装作者为
Microsoft、ID 为ms-ceintl.vscode-language-pack-zh-hans的那个(带蓝白 VS 标志和蓝勾认证) - 安装后不要点右上角的
Reload按钮——它只重载扩展逻辑,不触发界面语言刷新 - 如果搜索不到该扩展,说明 VS Code 版本低于
1.13,需先升级到最新版
Configure Display Language 命令里只能选 zh-cn,其他写法全无效
语言包装完只是“备好了字典”,真正决定显示语言的是 locale 配置值。这个值必须严格匹配 BCP 47 标准,大小写、连字符、拼写错一个字符,VS Code 就回退英文。
- 按
Ctrl+Shift+P输入Configure Display Language,选中后回车 - 在弹出列表中只选
zh-cn(小写,连字符,不能是zh_CN、zh-hans、Chinese或zh) - 出现“需要重启窗口”提示时,必须点
Restart,否则配置不生效 - 若命令面板无反应或列表为空,说明语言包未成功加载,优先检查扩展是否真安装完成
手动编辑 locale.json 是最稳的兜底方式
当命令面板打不开、切换失败或企业策略锁定设置时,直接改配置文件绕过 UI 层,强制生效。关键是路径、编码、格式三者都得对,否则白改。
- 先彻底关闭所有 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 - 用 VS Code 自己打开该文件,内容仅写一行:
{"locale":"zh-cn"}(UTF-8 无 BOM,无多余空格或逗号) - 保存后必须全新启动 VS Code,不能复用旧窗口
验证是否真生效,别被局部英文骗了
终端、调试控制台、Git 面板、某些插件 WebView 页面显示英文 ≠ 汉化失败。VS Code 的 locale 配置只影响主 UI 层,不接管所有子系统。
- 重点验证三处:
顶部菜单栏(如「文件」「编辑」「视图」)、命令面板(Ctrl+Shift+P后提示文字)、设置界面(Ctrl+,左侧导航和搜索占位符) - 如果这三处是中文,就说明 locale 设置成功;其余区域英文属正常现象
- Remote-SSH / WSL 场景下,语言包和
locale.json必须在远程环境中也执行一遍 - 最常被忽略的是“没关干净”——后台进程还在跑,新窗口复用旧环境,看起来像没生效


















