VSCode扩展安装失败多因环境配置、权限或网络问题，而非VSCode本身故障；需检查extensions.installDir路径、网络连通性、代理设置、目录权限、exthost日志及扩展兼容性。
检查 extensions.installDir 是否被错误自定义
很多人为了“统一管理插件”，在 settings.json 里手动加了 "extensions.installDir"，但路径不存在、拼写错误或没写权限，会导致所有扩展安装静默失败（连错误提示都不完整）。
- 打开 VSCode 设置（
Ctrl+,），搜索extensions.installDir，如果该配置存在，先注释或删掉它 - 确认默认扩展目录可写：
ls -la ~/.vscode/extensions/
（Linux/macOS）或dir %USERPROFILE%\.vscode\extensions
（Windows）；若报Permission denied，运行sudo chown -R $(whoami) ~/.vscode
- 不要把扩展目录设到系统保护路径（如
/usr/local或C:\Program Files），哪怕你用了管理员身份启动
验证网络链路是否真正打通 marketplace.visualstudio.com
VSCode 安装扩展时不只是下载文件，还会向市场服务发起 HTTPS 请求校验签名、获取元数据。企业网、校园网、甚至某些国产杀软会拦截这类请求，导致 Error: Unable to fetch marketplace extensions 或安装后不激活。
OpenGemini Next.js Bestpractice Builder
下载
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
- 终端执行：
curl -I https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1/vscode
，看是否返回200 OK；若超时或拒绝，说明网络不通 - 检查三处代理设置是否冲突：
settings.json中的http.proxy、系统级代理（Windows 设置 → 代理 / macOS 网络设置）、以及环境变量HTTP_PROXY和HTTPS_PROXY—— 三者必须一致或全部清空 - 临时禁用在线校验（仅限可信扩展）：
{ "extensions.autoUpdate": false, "http.proxyStrictSSL": false }，避免证书验证失败阻断安装
手动安装 .vsix 时遇到 EACCES: permission denied, mkdir
这不是 VSCode 的 bug，是操作系统阻止了对用户目录的写入。尤其常见于 Linux/macOS 上家目录权限被意外收紧（比如误执行了 chmod -R 700 ~ 后未恢复）。
- 先确认当前用户对
~/.vscode完全可控：ls -ld ~/.vscode
，输出应类似drwxr-xr-x，且 owner 是你自己 - 修复权限（谨慎操作）：
sudo chown -R $USER:$USER ~/.vscode
，然后chmod -R u+rw ~/.vscode
；不要给~整体设 700，那会破坏 SSH、Git 等工具的密钥读取 - 安装前校验
.vsix文件本身是否损坏：unzip -t your-extension.vsix
；若报错，立刻重新从 Visual Studio Marketplace 下载
查看 exthost 日志定位真实失败点
VSCode 的图形界面提示往往过于笼统（比如只说 “Failed to install”），真正关键的线索藏在扩展主机日志里 —— 这是唯一能区分“网络失败”“签名失败”“解压失败”“激活失败”的依据。
- 快捷键
Ctrl+Shift+P→ 输入并运行Developer: Open Extension Logs，选最新日期下的exthost日志文件 - 搜索关键词：
error、failed、download、signature、mkdir；例如看到Signature verification failed就说明代理或本地时间不准干扰了证书校验 - 日志路径也可直查：
~/.config/Code/logs/（Linux）、~/Library/Application Support/Code/logs/（macOS）、%APPDATA%\Code\logs\（Windows）
engines.vscode 字段不匹配而拒绝加载，但安装过程却显示“成功”**。此时要打开命令面板运行 Extensions: Show Installed Extensions，点开扩展详情页，看右上角是否标着 “Incompatible”。别只信安装弹窗，得看它到底有没有真活过来。 
