离线安装.vsix失败主因是解压、注册或权限问题，需查extension host日志确认是否加载；若搜不到扩展id则未触发注册，搜到“failed to activate”则启动失败；同时检查main.log、权限、路径大小写及.vsix完整性。
离线安装 .vsix 失败，日志里往往没报错，但插件就是不出现、不激活——问题大概率卡在解压、注册或权限环节，而不是网络。必须主动翻日志，不能等 VS Code 提示。
怎么看 Extension Host 日志里有没有真实加载
插件列表显示“已安装”，但功能没生效，说明 exthost 进程根本没加载它。这不是 UI 刷新问题，是扩展主机跳过了这个扩展。
- 按
Ctrl+Shift+P（macOS 用Cmd+Shift+P），输入并运行Developer: Open Extension Logs - 在打开的日志侧边栏中，选
Extension Host对应的最新日志文件 - 搜索你的扩展 ID（比如
ms-python.python）或install关键词：如果完全搜不到，说明安装命令压根没触发注册流程；如果看到Failed to activate extension，说明已注册但启动失败 - 常见线索：
Cannot find module（路径错误）、Activation failed because the extension is not installed（目录结构损坏）、ENOENT: no such file or directory, open '.../package.json'（解压不完整）
为什么 code --install-extension 显示成功却没效果
这个命令只负责把 .vsix 解压到 ~/.vscode/extensions/ 并写入 extensions.json，但它不校验内容完整性，也不重启 exthost。静默失败非常常见。
- 先确认目标目录是否可写：
ls -la ~/.vscode/extensions/，若提示Permission denied，需修复权限：chown -R $(whoami) ~/.vscode/extensions/ - 检查解压结果：
ls -la ~/.vscode/extensions/ms-python.python-*，正常应有package.json、extension.js等文件；若只有空文件夹或缺失关键文件，说明.vsix损坏或解压被中断 -
.vsix是 ZIP 格式，可用unzip -t your-extension.vsix验证压缩包完整性；Windows 资源管理器拖放重打包会破坏 ZIP 结构，必须用7-Zip或zip命令重压
main.log 里藏着安装时的真实失败点
main.log 记录编辑器启动和初始化全过程，比扩展日志更底层。很多离线安装失败其实发生在首次加载阶段，比如配置文件缺失、扩展依赖未满足、甚至 locale 初始化崩溃。
- 运行
Developer: Open Logs Folder，进入对应日期的子目录，打开main.log - 搜索
bootstrap、startup、error、failed，重点关注启动初期的堆栈 - 典型问题：
ENOENT: no such file or directory, open '/home/user/.vscode/extensions/ms-python.python-*/package.json'（路径名大小写不一致，Linux 下敏感）；Invalid or unexpected token（package.json被改坏或编码异常）；Cannot read property 'locale' of undefined（语言包冲突导致整个扩展系统加载失败） - 若日志里反复出现
ExtensionHostProcess exited with code: 1，基本可判定某个扩展的activate()方法抛了未捕获异常，需结合exthost日志定位具体扩展
离线环境最易忽略的是权限链和路径一致性：Windows 上以普通用户身份运行 VS Code，却试图往管理员安装路径写扩展；Linux 下用 sudo code 启动，导致扩展装到 root 目录，普通用户启动时根本看不到；还有人把 .vsix 放在 OneDrive 或云同步目录里，解压中途被后台同步进程锁住文件——这些都不会报明显错误，只会让日志里安静地少一行加载记录。
