离线环境下VSCode设中文必须用MS-CEINTL官方.vsiz包、通过命令面板“Install from VSIX”安装、执行Configure Display Language选zh-cn并彻底重启;手动复制文件夹、双击安装、改settings.json均无效。

离线环境下 VSCode 能设成中文,但必须用 ms-ceintl.vscode-language-pack-zh-hans 官方 .vsix 包 + 正确安装路径 + 严格匹配版本,三者缺一不可。手动复制文件夹、双击安装、改 settings.json 都无效。
怎么下载真正能用的离线语言包
必须从微软官方渠道获取,且验证发布者和版本兼容性:
- 打开官网页面:
https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans(注意 ID 必须是MS-CEINTL,不是个人或其它组织) - 拉到页面底部,点 Download Extension,得到形如
MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix的文件 - 在联网机上运行
code --version,记下主版本号(如1.104.2),确保下载的.vsix中的engines.vscode字段匹配(如"^1.104.0") - 别用百度网盘、第三方镜像站或搜“VSCode汉化”跳转的链接——90% 是过期包或带副作用的封装器
为什么不能直接复制 extensions 文件夹
VSCode 不识别未注册的扩展。手动把别人电脑上解压好的 ms-ceintl.vscode-language-pack-zh-hans-xxx 文件夹拷进 %USERPROFILE%\.vscode\extensions\(Windows)或 ~/.vscode/extensions/(macOS/Linux),VSCode 启动时完全忽略它:
- 缺少
.metadata注册记录,扩展列表里不显示 - 不触发语言资源加载流程,
locale.json再正确也无用 - 右下角始终显示
en,设置页、终端、调试面板全是英文,且无任何报错提示
离线安装必须走 “Install from VSIX” 命令
这是唯一被 VSCode 主程序认可的离线安装入口,自 1.70 版起禁用双击/拖拽机制:
- 在离线机上启动 VSCode,按
Ctrl+Shift+X打开扩展面板 - 点击右上角
⋯→ 选 Install from VSIX… - 定位并选中你传入的
.vsix文件,点击Install - 安装完成后,右下角会弹出提示,必须点 Change Language and Restart(不是只点 Restart)
- 若没弹提示,手动执行
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn→ 点Restart
locale.json 配置和重启细节容易失效
即使语言包装对了,界面仍英文,大概率卡在这三处:
-
locale.json必须放在用户级路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json
内容只能是严格 JSON 格式:{"locale":"zh-cn"}(小写、连字符、UTF-8 无 BOM) - 重启不彻底:Windows 要在任务管理器杀掉所有
Code.exe进程;macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron",再启动 - 系统 locale 干预:Windows 若启用了「Beta: Use Unicode UTF-8 for worldwide language support」且区域设为 English,VSCode 会跳过语言包;macOS/Linux 下临时运行
LANG=zh_CN.UTF-8 code可验证是否是此问题
最常被忽略的是:安装 .vsix 后没点 Change Language and Restart,而是只点了普通重启,或者误以为“装完就自动生效”。VSCode 的语言切换是两阶段动作——先装包,再显式选择并重启,少一步都不行。











