必须安装microsoft官方中文语言包并执行configure display language命令设为zh-cn后彻底重启,三者缺一不可;装第三方“汉化插件”无效且危险。

VSCode 没有“中文补丁”这个东西,所谓“补丁”是误传;真正起作用的只有 Microsoft 官方语言包 Chinese (Simplified) Language Pack for Visual Studio Code,装错第三方扩展(比如名字带“汉化”“补丁”“中文支持”的)不仅无效,还可能破坏配置或引入异常行为。
怎么确认你装的是官方语言包
在扩展面板(Ctrl+Shift+X)里搜索时,必须逐字输入全名:Chinese (Simplified) Language Pack for Visual Studio Code。只认发布者为 Microsoft、扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans 的那个。其他任何名称相似的——如 Chinese Language Pack、VSCode Chinese、简体中文补丁——全部跳过。
- 图标是蓝白 VS Code logo + 中文“中”字,不是纯文字或模糊图标
- 安装后右下角会弹提示:“Language changed to Chinese (Simplified). Reload window to apply?” → 这个提示出现,才说明插件已成功加载资源
- 如果没弹提示,或命令面板搜不到
Configure Display Language,基本就是没装上
Configure Display Language 命令为什么找不到或不生效
这个命令不是“设置里点几下就出来”的功能,它依赖语言包已正确安装并完成初始化。常见失效原因:
- 插件安装后只点了
Reload Window,但没彻底退出进程(Windows 任务管理器仍有Code.exe,macOS 活动监视器有Electron) - 执行命令后选了
zh-cn,但误点了“否”或关闭弹窗,没点Restart - 选错值:写成
zh_CN、zh-hans、zh或Chinese—— 全部无效,VS Code 只认严格小写的zh-cn - VS Code 版本低于 1.13(2026 年绝大多数用户不会遇到,但老旧企业镜像可能仍存在)
手动改 locale.json 是最稳的兜底方式
当命令面板打不开、插件市场无法访问、或反复失败时,直接编辑配置文件比重装更高效。注意三个硬性条件:
- 路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 内容只能是纯 JSON:
{"locale":"zh-cn"},不能加注释、不能用单引号、不能多空格 - 编码必须是 UTF-8 无 BOM —— 用 VS Code 自己打开并保存,右下角状态栏确认显示
UTF-8,不是GBK或UTF-8 with BOM - 改完必须关掉所有 VS Code 进程再重开,残留进程会继续读旧缓存
真正卡住人的地方,往往不是找不到插件,而是以为“装了=生效”,忽略了 Configure Display Language 这一步,或重启不彻底。VS Code 的 locale 切换是运行时行为,不是静态配置,没走完这三步闭环(装对插件 + 执行命令 + 彻底重启),界面永远是英文。











