离线安装vscode中文包唯一可靠路径是:先通过命令面板执行extensions: install from vsix安装官方ms-ceintl发布的.vsiz包,再手动运行configure display language选zh-cn,最后彻底重启;双击、拖拽或code --install-extension均99%静默失败。

离线安装 VSCode 中文包,唯一可靠路径是通过命令面板执行 Extensions: Install from VSIX,再手动运行 Configure Display Language 并选 zh-cn,最后彻底重启——双击 .vsix、拖拽进窗口、或用 code --install-extension 命令行安装,99% 静默失败且无提示。
怎么下载真正能用的官方 .vsix 文件
不能搜“VSCode 中文包”随便点网盘链接,必须认准发布者 MS-CEINTL 和扩展 ID ms-ceintl.vscode-language-pack-zh-hans:
- 打开微软官方语言包页面(GitHub 或 marketplace.visualstudio.com),拉到最底部点 Download Extension,文件名形如
MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix - 右键解压该 .vsix(它本质是 zip),打开
package.json,确认"engines": {"vscode": "^1.104.0"}与你本地code --version输出的主版本号一致(如输出1.104.2,则匹配^1.104.0) - 别用百度网盘、第三方镜像站或带“汉化”字样的压缩包——过期率高,签名常失效,部分还夹带静默行为
为什么双击 .vsix 文件不生效
VSCode 自 1.70 版起已禁用直接加载机制。双击或拖拽只是把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载流程,也不写入激活状态:
- 现象:右下角仍显示
en,设置页、命令面板、调试视图全英文,且无任何错误提示 - 验证方式:打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans,若未显示“已启用”,说明根本没注册成功 - 补救操作:先点击扩展右上角
⋯ → Uninstall,再走命令面板重装
装完 .vsix 后界面还是英文?关键在三步激活
语言包只是“字典”,真正告诉 VSCode “用中文显示”的动作是 Configure Display Language。它不是自动运行的,必须手动触发:
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(若搜不到,说明插件未注册,重试上一步) - 从下拉列表中**明确选
zh-cn**(小写、短横线、不能是zh_CN、zh-hans、Chinese或带空格的"zh-cn ") - 弹出提示后务必点 Restart(不是 Reload Window);若没弹提示,检查后台进程:Windows 杀光所有
Code.exe,macOS/Linux 运行pkill -f "Code Helper"和pkill -f "Electron"
远程开发(SSH/WSL)需单独部署
本地装了中文包,对远程窗口完全无效。远程环境必须重复两步:Install from VSIX + Configure Display Language:
- 点击右下角状态栏的
SSH: xxx→ 点Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,同样要运行
Configure Display Language并选zh-cn→ 重启远程窗口 - 注意:远程机器若无图形界面,需确保
locale.json路径正确(Linux:~/.config/Code/User/locale.json),内容严格为{"locale":"zh-cn"},UTF-8 无 BOM
最容易被忽略的是:装完 .vsix 不等于激活,选 zh-cn 不等于生效,点 Reload Window 不等于切换语言——这三处错任一都会导致全英文界面持续存在,且毫无报错提示。











