VSCode离线安装中文语言包必须通过命令面板执行Extensions: Install from VSIX并选择MS-CEINTL发布的vsix文件,安装后还需手动运行Configure Display Language选zh-cn并重启,远程环境需单独部署且无图形界面时须手动写入locale.json。

离线安装必须走 Extensions: Install from VSIX
双击或拖拽 .vsix 文件进 VSCode 窗口,99% 失败——VSCode 自 1.70 版起已禁用该机制,静默复制文件但不注册扩展。真正生效的路径只有一条:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中 vscode-language-pack-zh-hans-*.vsix(发布者必须是 MS-CEINTL)→ 点 Install。
常见错误现象包括:扩展面板里看不到 ms-ceintl.vscode-language-pack-zh-hans、右下角仍显示 en、设置页全英文。这说明语言包只是存进了 ~/.vscode/extensions/ 或 %USERPROFILE%\.vscode\extensions\,但没激活。
Configure Display Language 必须手动选 zh-cn 并 Restart
装完 .vsix 不等于界面变中文。必须再执行一次 Ctrl+Shift+P → Configure Display Language → 明确选 zh-cn(小写、短横线、不能是 zh-hans 或 zh_CN)→ 点 Restart(不是 Reload Window)。
若命令面板搜不到 Configure Display Language,说明插件根本没注册成功,得重装;若选完没弹提示,检查后台残留进程:
– Windows:任务管理器杀光所有 Code.exe
– macOS:活动监视器杀掉 Electron 进程
– Linux:运行 pkill -f "Code Helper" 和 pkill -f "Electron"
远程开发环境要单独部署
本地装了中文包,对 SSH / WSL 远程窗口完全无效。必须在目标机器上重复两步:
– 点右下角状态栏的 SSH: xxx → Install 'Chinese (Simplified) Language Pack' in SSH: xxx
– 安装完成后,同样运行 Configure Display Language 并选 zh-cn → 重启远程窗口
注意:远程机器若无图形界面,需手动写入 locale.json:
– Linux 远程:~/.vscode-server/data/Machine/locale.json
– Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
内容严格为:{"locale":"zh-cn"}(UTF-8 无 BOM,无空格,无多余逗号)
批量部署建议用 CLI + 绝对路径
对多台电脑批量操作,推荐脚本化安装:
– 先确保 code 命令可用:Ctrl+Shift+P → Shell Command: Install 'code' command in PATH
– 使用绝对路径执行安装(相对路径几乎必失败):code --install-extension "C:/ext/vscode-language-pack-zh-hans-1.95.0.vsix"code --install-extension "/home/user/ext/vscode-language-pack-zh-hans-1.95.0.vsix"
关键细节:
– 路径含空格或中文,必须加英文双引号
– 插件版本需与 VSCode 主版本兼容(例如 v1.95 的语言包不能装到 v1.92 上)
– 安装后仍需人工触发 Configure Display Language,CLI 无法替代这一步
最容易被忽略的是:语言包安装和 locale 配置是两个独立动作,缺一不可;而远程开发场景下,每台目标机器都得各自完成这两步——不存在“一次配置,处处生效”。


















