离线安装多个语言包必须用官方签名的单语言.vsix文件逐一安装,装完后通过configure display language命令选择zh-hans等id并彻底退出重启;手动改argv.json为{"locale":"zh-hans"}更可靠,大小写敏感且不能误改settings.json。

离线安装多个语言包必须用 .vsix 文件
VSCode 离线环境不走扩展市场,所有语言包都得手动下载 .vsix 文件再安装。官方语言包统一发布在 GitHub 的 vscode-loc 仓库(如 vscode-language-pack-zh-hans、vscode-language-pack-ja),文件名带语言代码和版本号,例如:vscode-language-pack-zh-hans-1.85.0.vsix。
关键点:
- 每个语言包是独立
.vsix,不能靠改一个配置就“多语言共存” - 必须先全部安装完,
Configure Display Language命令才能列出多个选项 - 第三方打包的“多语言合集”
.vsix不可靠——VSCode 只认微软签名的单语言包
安装后切换语言只靠 Configure Display Language 命令
装好多个语言包后,切换界面语言仍走同一入口:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Configure Display Language 回车。弹出的列表里会显示所有已安装且被识别的语言 ID,比如 zh-hans、ja、en、fr。
注意几个硬性规则:
-
zh-hans和zh-cn都可被识别,但优先用zh-hans(VSCode 官方文档和最新语言包默认用此) -
zh-tw、zh-hant不在运行时支持列表中,选了也会静默回退到en - 切换后必须完全退出 VSCode(Windows 检查任务管理器无
Code.exe,macOS 确认Electron进程已终止),否则旧 locale 缓存仍在
手动编辑 locale.json 是最稳的离线切换方式
命令面板在离线环境下有时无法加载语言列表(尤其刚装完包未重启过),这时直接改配置更可靠。执行 Ctrl+Shift+P → 输入 Preferences: Configure Runtime Arguments,它会打开 argv.json 文件(路径在用户数据目录下的 .vscode 子目录)。
把内容改成标准 JSON 格式,仅保留一行:
{"locale":"zh-hans"}
保存后全退出再重开。这个方式绕过了命令面板的动态加载逻辑,只要语言包已安装,就一定生效。
常见误操作:
- 写成
{"locale": "ZH-HANS"}(大小写敏感,必须小写) - 加了多余逗号或空格,导致 JSON 解析失败,VSCode 启动卡在白屏
- 误改了
settings.json而非argv.json——后者才是控制全局 UI 语言的配置
切换后部分 UI 仍是英文?不是语言包问题,是插件或缓存
即使 locale 设对、语言包装全,你仍可能看到 Git 面板、调试控制台、某些设置项是英文。这不是切换失败,而是:
- 第三方插件(如
Prettier、GitLens)的提示文案不读取 VSCode 的locale,需单独查它们是否支持语言配置 - VSCode 自身部分新功能(如 Remote Explorer、Notebook 内核提示)本地化滞后,新版才逐步覆盖
- 缓存没清干净:离线环境更容易残留旧资源,删掉
Cache目录(Windows:%APPDATA%\Code\Cache)再试
真正自由切换的前提,是接受“VSCode 只保证核心 UI 可切”,其余依赖生态跟进——这点在离线部署时尤其明显。











