离线安装vscode中文包唯一可靠路径是:用命令面板执行extensions: install from vsix安装官方vscode-language-pack-zh-hans-*.vsix(发布者ms-ceintl),再运行configure display language选zh-cn并彻底重启;双击、拖拽、复制文件夹或code --install-extension均静默失败。

离线安装 VSCode 中文包,唯一可靠路径是用 Extensions: Install from VSIX 命令加载官方 .vsix 文件,再手动执行 Configure Display Language 并选 zh-cn,最后彻底重启——双击、拖拽、复制文件夹或 code --install-extension 命令均不可靠,多数静默失败。
怎么拿到真正能用的 .vsix 文件
必须从微软官方渠道下载,发布者 ID 必须是 ms-ceintl,扩展 ID 必须是 ms-ceintl.vscode-language-pack-zh-hans。其他任何名字相似的包(比如 chinese-language-pack、作者是个人 ID 的)基本无效。
- 在可联网机器上打开 VSCode,按
Ctrl+Shift+X进扩展面板,搜Chinese (Simplified) Language Pack for Visual Studio Code,确认发布者为 Microsoft(带蓝标) - 点击右上角 ⋯ →
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就算兼容) - 别用百度网盘链接、第三方镜像站或“VSCode 汉化包.exe”——过期率高,签名常失效,部分含静默行为
Install from VSIX 必须走命令面板,不能双击或拖拽
VSCode 自 1.70 起已禁用文件系统直接加载机制。双击或拖入只是把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不注册扩展 ID、不触发资源加载流程,也不会写入激活状态。
- 在离线机上启动 VSCode,按
Ctrl+Shift+P打开命令面板,输入并选择Extensions: Install from VSIX - 选中你传入的
.vsix文件,点Install - 安装完成后,不要点 “Reload Window”,它不生效;也不要点右下角可能弹出的 “Restart Now” 提示(若出现),先做下一步
- 验证是否真装上了:打开扩展面板,搜
ms-ceintl.vscode-language-pack-zh-hans,看是否显示 “已启用” 状态;若没出现或显示 “未启用”,说明安装未成功,需先Uninstall再重试
装完 ≠ 中文生效,Configure Display Language 是关键一步
语言包只是资源容器,VSCode 不会自动启用它。必须显式调用 Configure Display Language 命令,并严格选 zh-cn(小写、短横线、无空格、无引号包裹),然后点 Restart(不是 Reload)。
- 按
Ctrl+Shift+P,输入Configure Display Language,回车后从下拉列表中选zh-cn -
zh-hans在 1.95+ 版本中仅加载基础 UI 字符串,设置页、调试面板仍为英文;zh_CN、Chinese、zh全部不识别 - 若命令面板搜不到这个命令,说明语言包未成功注册,重试上一步安装流程
- 选完后务必点
Restart—— Windows 上要确认任务管理器中所有Code.exe进程已退出;macOS/Linux 上执行pkill -f "Electron"或pkill -f "Code Helper",再启动
远程开发环境需单独部署,本地安装完全无效
如果你通过 SSH 或 WSL 连远程机器,本地装的中文包对远程窗口毫无作用。必须在目标机器上重复上述两步:Install from VSIX + Configure Display Language。
- 点击右下角状态栏的
SSH: xxx→ 点击Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,同样运行
Configure Display Language并选zh-cn→Restart - 若远程无图形界面(如纯 Linux 服务器),需手动写入
locale.json:Linux 路径为~/.vscode-server/data/Machine/locale.json,内容仅一行:{"locale":"zh-cn"}(UTF-8 无 BOM) - 验证时只看三处:顶部菜单栏、命令面板提示、设置导航栏——终端、Git 输出、右下角状态栏本就不走 locale 配置,它们显示英文不等于汉化失败
最容易被忽略的是:VSCode 启动时会读取系统 locale 干预语言协商。Windows 若启用了 “Beta: Use Unicode UTF-8 for worldwide language support”,且区域设为 English (United States),VSCode 可能跳过语言包;Linux/macOS 下若 $LANG 是 en_US.UTF-8,也建议临时设为 zh_CN.UTF-8 再启动一次验证。











