VSCode 1.70+ 禁用双击/拖拽安装 .vsix,必须通过 Ctrl+Shift+P → Extensions: Install from VSIX 安装;语言包需配合 locale.json 配置、Configure Display Language 命令及彻底重启才生效,远程开发需在目标端重复全流程。

离线安装.vsix文件没反应,根本不是文件问题
直接双击或拖拽 .vsix 文件进 VSCode 窗口,99% 静默失败——VSCode 自 1.70 起已禁用该机制,连错误提示都不给。它只是把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但完全不注册扩展 ID,也不触发语言资源加载。
- 唯一有效路径:按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中文件 → 点Install - 验证是否真装上:打开扩展面板,搜
ms-ceintl.vscode-language-pack-zh-hans,必须显示“已启用”状态 - 若拖放无反应,先确认 VSCode 已打开至少一个文件或文件夹(纯空白启动时拖放被忽略)
装完还是英文?locale.json 路径和值全对才生效
VSCode 1.70+ 版本只认用户级 locale.json 文件里的 {"locale": "zh-cn"},其他任何地方写的都无效,包括 settings.json、工作区配置、甚至命令面板里输错的选项。
- 路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容必须严格为:
{"locale": "zh-cn"}(小写、短横线、双引号、UTF-8 无 BOM 编码) -
zh-hans、zh_CN、Chinese全部不识别;zh-cn(末尾空格)也会被忽略
Configure Display Language 必须手动执行且选对值
装完语言包 ≠ 界面变中文。VSCode 不会自动激活,必须通过命令面板显式设置并重启。跳过这步,重装十遍也没用。
- 按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn(注意是小写、短横线,不是下划线)→ 点Restart(不是Reload Window) - 如果命令面板搜不到该命令,说明语言包根本没注册成功,需重走
Install from VSIX步骤 - 点
Restart后没弹窗?检查后台进程是否残留:Windows 杀光所有Code.exe,macOS/Linux 执行pkill -f "Code Helper"和pkill -f Electron
版本不匹配导致 not compatible with Code
从官网下载的 vscode-language-pack-zh-hans-1.90.2.vsix 装不进 1.96.3 版本,报错本质是 package.json 里 "engines": {"vscode": "^1.90.0"} 和本地主版本号不匹配,不是签名或网络问题。
- 解压
.vsix(用7-Zip或unzip,别用 Windows 资源管理器),打开extension/package.json - 将
"engines": {"vscode": "^1.90.0"}改成你本地code --version输出的完整版本号,例如"engines": {"vscode": "1.96.3"} - 重新打包为 ZIP,后缀改为
.vsix,再通过Extensions: Install from VSIX安装
.vsix、运行 Install from VSIX、写远程端的 locale.json、执行 Configure Display Language 并彻底重启远程窗口。


















