VSCode 插件安装出现 connect ETIMEDOUT 错误，核心原因是网络连通性问题，导致客户端无法在指定时间内连接到扩展市场服务器。

通过开发者工具定位请求失败

在尝试修复前，建议先确认具体的请求失败情况。

1. 点击菜单栏 Help -> Toggle Developer Tools。
2. 在打开的窗口中选择 Network 标签页。
3. 重试插件安装操作，观察是否有标红的失败请求。
4. 点击失败请求，查看 Timing 或 Error 信息，确认是 DNS 解析失败还是连接超时。

配置网络代理与 SSL 设置

如果你拥有可用的网络代理地址，可以直接在 VSCode 设置中修改配置。打开设置文件 settings.json，添加或修改以下项：

"http.proxy": "http://你的代理地址：端口",
"http.proxyStrictSSL": false

⚠️ 安全风险提示：关闭 SSL 验证（proxyStrictSSL: false）可能导致中间人攻击风险。仅在信任的网络环境下临时使用，生产环境建议配置正确的证书链。

修改 Hosts 文件加速解析

DNS 解析慢也是导致超时的常见原因。可以通过修改 Hosts 文件指定市场服务器 IP。

文件路径：

• Windows: C:\Windows\System32\drivers\etc\hosts
• Mac/Linux: /etc/hosts

配置示例：

# 示例 IP 可能随时间失效，请自行查询可用 IP
127.0.0.1 marketplace.visualstudio.com

修改后需刷新 DNS 缓存（Windows 运行 ipconfig /flushdns）。

命令行离线安装插件

如果图形界面安装失败，可使用命令行工具手动安装 .vsix 文件。

1. 在浏览器访问 marketplace.visualstudio.com 下载插件的 .vsix 文件。
2. 打开终端，确保 code 命令可用。
3. 执行安装命令：

code `--install-extension` 插件路径/插件名.vsix

或者通过插件 ID 安装（需网络通畅）：

code `--install-extension` ms-vscode.cpptools

验证与常见风险

安装完成后，在左侧扩展栏查看该插件是否显示“已启用”。尝试安装一个体积较小的官方插件（如 ESLint），如果不再报错即表示网络或安装路径已恢复正常。

常见坑：

• 代理地址填写错误：确保包含协议头（http:// 或 https://）。
• 企业防火墙：公司网络可能禁止外部下载，需联系 IT 部门。
• 版本不匹配：手动下载的 vsix 文件需与 VSCode 版本兼容，否则无法加载。
• SSL 配置风险：临时关闭 SSL 验证后，记得在安全网络中恢复默认设置。