vs code 设置中文必须安装微软官方语言包 ms-ceintl.vscode-language-pack-zh-hans,执行 configure display language 命令并选 zh-cn,再彻底重启所有进程;搜“中文”“汉化”易装错第三方插件,手动编辑 locale.json 为 {"locale":"zh-cn"} 是可靠兜底方案。

搜索时必须输全名,不能搜“中文”或“汉化包”
在扩展面板(Ctrl+Shift+X)里直接搜“中文”“汉化”“zh-cn”“简体中文”,大概率命中第三方插件,比如 Chinese Menu 或 VSCode Chinese。这些插件不维护、不翻译设置项、命令面板仍是英文,有些还会弹广告或改主页。
唯一正确的做法是:逐字粘贴全名:Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写都必须一致)。搜完后只认发布者为 Microsoft、ID 为 ms-ceintl.vscode-language-pack-zh-hans 的那个——图标带蓝白 VS 标志和中文“中”字。
- 搜不到?检查 VS Code 版本是否低于
1.13,需先升级 - 搜到多个同名?只装作者栏写着
Microsoft的那个 - 安装后右下角没弹提示?不是失败,而是 UI 提示被禁用或卡住,仍需手动重启
装完不等于生效,必须执行 Configure Display Language 命令
语言包只是“字典”,真正告诉 VS Code “用中文显示”的动作是 Configure Display Language 命令。它不会自动触发,也不依赖插件安装完成就立刻运行。
操作路径:Ctrl+Shift+P → 输入 Configure Display Language → 回车 → 在列表中选 zh-cn(注意:小写、短横线、无空格;zh_CN、zh-hans、Chinese 全无效)→ 点提示里的 Restart。
- 命令面板里搜不到这个命令?说明语言包根本没装成功,或装完没重启过任何窗口
- 点了
zh-cn但没点 Restart?界面不会变,只会静默写入配置 - 误点了
Developer: Reload Window?它只重载插件逻辑,不加载语言资源,无效
locale.json 手动编辑是绕过 UI 失效的兜底方案
当命令面板打不开、UI 卡死、公司内网无法访问扩展市场,或批量部署时,直接改 locale.json 是最稳的方式。VS Code 启动时优先读取这个文件,且它的优先级高于 settings.json 中的 locale 字段。
操作步骤:
- 彻底关闭所有 VS Code 窗口(Windows 查任务管理器中所有
Code.exe进程;macOS 查活动监视器里的Electron;Linux 用pkill code) - 找到并用纯文本编辑器打开:
– 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
常见失效原因:装对了包,但没杀干净后台进程
很多人点了 Restart,但 VS Code 没真正退出后台进程,新窗口复用了旧的 locale 配置,导致界面仍是英文。这是最隐蔽也最容易被忽略的一环。
验证方式很简单:关掉所有窗口后,再打开任务管理器(或活动监视器),确认没有残留的 Code.exe / Electron / code 进程。只要有一个还在跑,中文就不会生效。
离线环境可去 GitHub 下载 vscode-language-pack-zh-hans.vsix,然后用命令 code --install-extension xxx.vsix 安装,后续步骤不变。











