必须安装Microsoft官方语言包ms-ceintl.vscode-language-pack-zh-hans并手动写入locale.json为{"locale":"zh-cn"},二者缺一不可;装第三方插件或仅改settings.json均无效,且须彻底退出所有进程后重启。

必须安装 Microsoft 官方语言包,并手动写入 locale.json 文件,二者缺一不可;只改 settings.json 或装错插件,界面一定不会变中文。
认准官方扩展 ID:ms-ceintl.vscode-language-pack-zh-hans
搜“中文”“汉化”大概率装错——第三方插件(如 Chinese Language Pack、VSCode Chinese)不提供完整翻译资源,只改菜单文字,且 2026 年起基本失效。唯一有效的是:
- 在扩展面板(
Ctrl+Shift+X)搜索Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,带蓝勾认证图标
- 安装后右下角弹出
Restart Now提示——必须点它,不是“关闭再打开”就行
Configure Display Language 命令只接受 zh-cn
这个命令本身不触发切换,只是往 locale.json 写配置。但它对输入格式极其敏感:
- 有效值只有
zh-cn(全小写、连字符) -
zh_CN、zh-CN、zh-hans、Chinese全部无效,且无任何错误提示 - 执行命令后若没弹重启提示,说明写入失败,需手动处理
locale.json
手动编辑 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)
终端和插件界面不显示中文是正常现象
VS Code 主界面语言不影响以下部分:
- 集成终端(bash/zsh/powershell)走系统 locale,和
locale.json无关 - 调试控制台(Debug Console)由调试器决定,比如 Node.js 默认英文
- 插件 WebView 页面(如 Copilot Chat、CodeBuddy)语言由服务端返回
- 部分插件(如 GitLens)需单独设
gitlens.language才能汉化
真正容易被忽略的,是 locale.json 的路径层级、编码格式,以及后台残留进程导致新窗口复用旧语言环境——这不是配置失败,而是进程没杀干净。


















