扩展无法加载通常由网络、版本或缓存问题导致。1. 确认网络可访问 marketplace.visualstudio.com，配置代理或换网络测试；2. 更新 VSCode 至最新版，避免兼容性问题；3. 删除 ~/.vscode/extensions 目录清除缓存后重装扩展；4. 检查扩展是否被禁用或冲突，禁用其他相似功能扩展排查；5. 以管理员身份运行 VSCode 并确保用户对安装目录有读写权限。多数问题通过以上步骤可解决。
VSCode 扩展无法正常加载，通常和环境配置、扩展本身或软件状态有关。下面列出常见原因及对应的解决方法，帮助你快速排查问题。
检查网络连接与扩展市场访问
VSCode 需要联网下载和验证扩展。如果你的网络受限，可能导致扩展加载失败。
- 确认你的网络可以正常访问互联网，尤其是 Microsoft 的服务（如 marketplace.visualstudio.com）
- 如果你在公司网络或使用代理，需在 VSCode 中配置代理设置：打开设置搜索 “proxy”，填写正确的代理地址
- 尝试切换网络（如改用手机热点）测试是否为网络问题
确认 VSCode 是否为最新版本
旧版本的 VSCode 可能不兼容新扩展，或存在已知的加载 bug。
- 点击菜单栏的 帮助 → 检查更新（macOS: Code → 检查更新）
- 升级到最新稳定版，重启编辑器后再尝试启用扩展
- 如果你使用的是 Theia、VSCodium 等衍生版本，某些扩展可能不支持
清除扩展缓存与重装问题扩展
扩展安装过程中可能出现文件损坏或权限问题。
- 关闭 VSCode
- 删除本地扩展目录：
- Windows: ~\.vscode\extensions
- macOS: ~/.vscode/extensions
- Linux: ~/.vscode/extensions
- 重新启动 VSCode，重新安装扩展
检查扩展冲突或禁用状态
某些扩展之间可能存在冲突，或被手动/自动禁用。
- 打开扩展面板（Ctrl+Shift+X），查看目标扩展是否显示为“已禁用”
- 尝试禁用其他不相关的扩展，特别是功能相似的（如多个 ESLint 或主题插件）
- 查看输出面板（视图 → 输出），选择对应扩展，看是否有错误日志
以管理员身份运行或检查文件权限
在某些系统上，安装目录权限不足会导致扩展无法写入或加载。
- 尝试以管理员身份运行 VSCode（右键快捷方式 → 以管理员身份运行）
- 确保当前用户对 ~/.vscode 目录有读写权限
- 避免将 VSCode 安装在受限制的系统目录（如 Program Files 下无权限子目录）
