vs code离线安装中文语言包后界面仍为英文,必须执行“configure display language”命令选择zh-cn并完全重启,且需确保code进程彻底终止、locale.json由该命令自动生成,不可手动编辑。

离线安装中文包后,VSCode 不会自动切语言——Configure Display Language 命令仍需执行,且 locale.json 必须由该命令生成或确认为 {"locale":"zh-cn"},否则界面保持英文。
怎么用命令行离线安装中文语言包
离线安装本质是绕过扩展市场,直接注入语言包文件。关键不是“装上就行”,而是确保包 ID 和 VSCode 版本兼容。
- 从微软官方 GitHub(
https://github.com/microsoft/vscode-loc/releases)下载对应 VSCode 版本的vscode-language-pack-zh-hans.vsix文件(注意匹配你本地 VSCode 的版本号,比如 1.93.x) - 打开终端,执行:
code --install-extension vscode-language-pack-zh-hans.vsix(Windows/macOS/Linux 均适用) - 若提示
command not found: code,说明code命令未加入 PATH;可改用绝对路径,例如 Windows 下:"C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd" --install-extension ... - 安装成功后,VSCode 右下角不会弹
Restart Now(因离线环境无网络检测),必须手动触发后续步骤
离线环境下如何设置全局语言为 zh-cn
离线时无法通过命令面板调出 Configure Display Language?那是因为该命令依赖已启用的语言包注册表项。安装 .vsix 后,它已注册,但需手动激活。
- 按
Ctrl+Shift+P(或Cmd+Shift+P)打开命令面板,输入Configure Display Language——只要包装对了,这个命令一定存在(不区分是否联网) - 若命令搜不到,说明
vsix安装失败或包 ID 不匹配;检查已安装扩展:Extensions: Show Installed Extensions,确认ms-ceintl.vscode-language-pack-zh-hans在列表中且状态为 Enabled - 选中
zh-cn后,VSCode 会自动生成或覆盖locale.json文件,路径为:~/.vscode/locales/vscode-language-pack-zh-hans.json(Linux/macOS)或%USERPROFILE%\AppData\Roaming\Code\locales\vscode-language-pack-zh-hans.json(Windows) - 别手动编辑这个文件:VSCode 会校验其完整性,手改可能触发回退到英文
为什么重启后还是英文?三个离线特有陷阱
离线场景下,失败往往不是因为没装包,而是进程残留、配置错位或路径冲突。
- 只关窗口不杀进程:Windows 任务管理器里仍有
Code.exe,macOS 活动监视器里残留Electron,Linuxps aux | grep code还有进程 —— 新开窗口会复用旧 locale,中文不生效 -
locale.json被其他工具污染:某些国产优化软件、旧版汉化插件、或手动写入过"locale": "zh"等非法值,会导致 VSCode 启动时静默忽略并 fallback 到 en - 远程开发(SSH / WSL)场景下,
locale.json必须放在远程机器的用户目录里,而不是本地;离线装包只作用于当前运行实例,远程窗口需单独安装并配置
真正卡住人的,从来不是“找不到安装包”,而是装完以为结束了,却漏掉了命令触发和进程清理这两个硬性环节。离线环境放大了每一步的容错率——没有网络兜底,每一步都得亲手确认。











