vscode离线安装中文包后终端仍显示英文是正常现象,因终端语言由系统locale决定而非vscode设置;需单独配置系统lang/lc_all为zh_cn.utf-8(linux/macos)或启用utf-8区域设置(windows),远程开发需在远程端重复安装并配置。

VSCode离线安装中文包后终端仍显示英文?不是语言包没装好,是终端根本不走 locale 配置
VSCode 的集成终端(Terminal)默认使用系统 shell,它的语言由操作系统环境变量(如 LANG、LC_ALL)决定,和 VSCode 界面语言完全无关。装完中文语言包、执行 Configure Display Language、重启 VSCode —— 这些操作只影响菜单、设置页、命令面板等 UI 区域,对终端内命令输出、提示符、错误信息毫无作用。
常见错觉是:“右下角状态栏显示 zh-cn,终端却还是英文,说明汉化失败”。其实这是正常现象,终端本就不该变中文。
如果你真需要终端里也显示中文(比如 ls 输出中文文件名、git status 显示中文路径、错误提示用中文),必须单独配置系统级 locale,而不是依赖 VSCode 设置:
- Linux/macOS:确保
LANG或LC_ALL环境变量设为zh_CN.UTF-8(注意是下划线,不是短横线;且系统需已生成该 locale) - Windows:控制面板 → 区域 → 管理 → 更改系统区域设置 → 勾选“Beta 版:使用 Unicode UTF-8 提供全球语言支持”(推荐),或直接设为“中文(简体,中国)”
- 在 VSCode 终端中验证:
echo $LANG(Linux/macOS)或echo %LANG%(Windows CMD)
离线安装中文包的唯一可靠方式:必须用命令面板 + .vsix 文件
双击或拖拽 vscode-language-pack-zh-hans-*.vsix 到 VSCode 窗口,从 VSCode 1.70 起已彻底禁用,静默失败且无任何提示——这是离线部署中最常踩的坑。
正确流程只有这一条路径:
- 提前从微软官方 GitHub(
https://github.com/microsoft/vscode-loc/releases)下载对应版本的vscode-language-pack-zh-hans-*.vsix(发布者必须是MS-CEINTL) - VSCode 启动后,按
Ctrl+Shift+P(macOS 用Cmd+Shift+P)打开命令面板 - 输入并选择
Extensions: Install from VSIX,回车 - 选中本地 .vsix 文件,点 Install
- 安装完成后,**必须立刻再执行一次**
Configure Display Language并明确选zh-cn(小写、短横线),然后点 Restart(不是 Reload Window)
远程开发(SSH/WSL)下中文包不生效?本地装了对远程零影响
VSCode 的语言包是进程级加载的,Remote-SSH 或 WSL 扩展启动的是远程机器上的独立 VSCode Server 进程,它完全不读取本地扩展目录或 locale.json。
必须在远程端重复完整流程:
- 点击右下角状态栏的
SSH: xxx或WSL: Ubuntu,选择Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 等待远程端安装完成(可能需几分钟,尤其首次下载)
- 再次按
Ctrl+Shift+P,在远程窗口中运行Configure Display Language→ 选zh-cn→ Restart - 若远程无图形界面(如纯 CLI 服务器),需手动创建或修改远程的
locale.json:
Linux 远程:~/.vscode-server/data/Machine/locale.json,内容为{"locale":"zh-cn"}(UTF-8 无 BOM)
Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
验证是否真生效?只看这三处,其他全是干扰项
别被终端、Git 提示、右下角状态栏文字骗了——它们压根不参与 VSCode 的 locale 协商逻辑。真正反映语言包激活成功的,只有以下三个位置全部变为简体中文:
- 顶部主菜单栏:
文件/编辑/视图/转到/调试/终端/帮助 - 命令面板提示语:
请输入命令或搜索设置(不是英文的 “Type the name of an action…”) - 设置页面左侧导航栏:
用户/工作区/扩展/键盘快捷方式/任务
如果其中任意一处仍是英文,说明 Configure Display Language 没成功写入或没重启干净——最稳妥的兜底动作是:杀光所有 VSCode 进程(Windows 任务管理器清空 Code.exe,macOS 活动监视器杀掉所有 Electron),再重新启动。











