双击或拖拽.vsix文件无效,因VSCode 1.70+已禁用该方式;必须通过命令面板执行Extensions: Install from VSIX安装,并配置locale.json为{"locale":"zh-cn"}后彻底重启进程。

必须用命令面板执行 Extensions: Install from VSIX,双击或拖拽 .vsix 文件完全无效。
为什么双击 .vsix 文件没反应
VSCode 自 1.70 版本起已禁用双击/拖拽安装方式,它会静默失败,不报错、不提示、也不写日志。文件可能被复制进 ~/.vscode/extensions/ 目录,但未注册为启用扩展,语言包根本不会加载。
- 常见现象:右下角状态栏仍显示
en,设置页、命令面板、调试面板全是英文 - 根本原因:VSCode 没把语言包“激活”,只当普通 ZIP 存了,不参与 UI 语言协商
- 验证方法:按
Ctrl+Shift+P→ 输入Extensions: Show Installed Extensions,搜ms-ceintl.vscode-language-pack-zh-hans,若不在列表中或状态为灰色,说明没装成功
正确安装步骤(离线环境必走流程)
确保你下载的是微软官方发布的 vscode-language-pack-zh-hans-*.vsix(发布者 MS-CEINTL,ID ms-ceintl.vscode-language-pack-zh-hans),然后:
- 彻底关闭所有 VSCode 窗口(Windows 查任务管理器中所有
Code.exe进程;macOS 查活动监视器里的Electron;Linux 执行pkill code) - 启动 VSCode(此时是纯英文界面)
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Extensions: Install from VSIX,回车 - 在弹出的文件选择框中定位并选中你下载的
.vsix文件,点击Install - 安装完成后,**不要点右上角 Reload,也不要关窗口**——继续下一步
装完还显示英文?关键在 locale.json 和重启
语言包只是“字典”,真正开关是 locale 配置。装完必须手动触发语言切换,且必须彻底重启进程:
- 按
Ctrl+Shift+P→ 输入Configure Display Language→ 回车 - 在下拉列表中**严格选择
zh-cn(小写、短横线、无空格)**,不是zh_CN、zh-hans或Chinese - 点击提示中的
Restart(注意:是“重启”按钮,不是“重新加载窗口”) - 如果命令面板卡死或搜不到该命令,直接编辑配置文件:
– Windows 路径:%APPDATA%\Code\User\locale.json
– macOS 路径:$HOME/Library/Application Support/Code/User/locale.json
– Linux 路径:$HOME/.config/Code/User/locale.json
文件内容仅一行:{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码
最容易被忽略的是后台残留进程——哪怕窗口关了,Code.exe 或 Electron 还在跑,新启动的 VSCode 会复用旧进程,导致 locale.json 不生效。每次改完配置,务必确认进程已清空再启动。


















