安装失败主因是网络或版本问题，可尝试切换网络、更新VSCode、配置代理、检查权限，或手动安装.vsix文件。
VSCode 扩展安装失败通常由几个常见原因导致，下面列出主要问题和对应的解决方法。
网络连接问题
VSCode 默认从官方扩展市场下载插件，若网络不稳定或被防火墙拦截，会导致安装失败。
VSCode 版本不兼容
某些扩展要求特定版本的 VSCode，旧版本无法支持新扩展。
- 检查当前 VSCode 版本（帮助 > 关于）
- 前往官网下载最新版并更新
- 部分扩展页面会提示“Requires Visual Studio Code
”，需满足该条件
扩展市场服务异常或地址错误
偶尔微软扩展市场会出现短暂故障或 DNS 解析问题。
- 访问 marketplace.visualstudio.com 确认网站是否可打开
- 修改系统 hosts 文件，添加正确的 IP 映射（适用于 DNS 污染）
- 临时更换 DNS 为 8.8.8.8 或 1.1.1.1 测试
权限或磁盘问题
VSCode 无法写入扩展安装目录时也会失败。
- 确认 VSCode 安装路径是否有写入权限（尤其是系统目录）
- 以管理员身份运行 VSCode 再尝试安装
- 检查磁盘空间是否充足
- 清理 ~/.vscode/extensions/ 目录下的残留文件
手动安装作为替代方案
如果在线安装始终失败，可以手动下载并安装扩展。
- 前往 Open VSX Registry 或 Visual Studio Marketplace 搜索对应扩展
- 下载后缀为 .vsix 的文件
- 在 VSCode 中打开命令面板（Ctrl+Shift+P），运行 Extensions: Install from VSIX
- 选择下载的文件完成安装
