VSCode插件无法下载或更新时,可通过四种方法配置代理:一、设置界面填HTTP代理;二、编辑settings.json添加http.proxy;三、设系统环境变量HTTP_PROXY/HTTPS_PROXY;四、启动时用code --proxy-server参数。

如果您在使用 VSCode 时无法下载或更新插件,可能是由于网络连接受阻,导致 VSCode 无法访问 marketplace.visualstudio.com 或 GitHub 等插件源服务器。以下是配置代理以恢复插件下载与更新功能的多种方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、通过 VSCode 设置界面配置 HTTP 代理
此方法适用于图形界面操作,无需修改配置文件,适合不熟悉命令行的用户。VSCode 会将代理设置写入用户 settings.json,并在启动时自动应用。
1、点击左下角齿轮图标,选择“设置”(Settings)。
2、在搜索框中输入 proxy。
3、找到“HTTP: Proxy”设置项,在其输入框中填入代理地址,格式为 http://127.0.0.1:10809(请替换为您的实际代理地址和端口)。
4、勾选“HTTP: Proxy Strict SSL”,若代理为自签名证书或需跳过 SSL 验证,则将其设为 false。
二、手动编辑 settings.json 文件配置代理
该方式直接修改配置文件,优先级高且稳定,适用于所有平台。配置项对插件市场、扩展安装、自动更新均生效。
1、按下 Cmd + Shift + P(macOS)或 Ctrl + Shift + P(Windows/Linux),打开命令面板。
2、输入并选择“Preferences: Open Settings (JSON)”。
3、在打开的 JSON 文件中添加以下两行(若已存在则修改值):
"http.proxy": "http://127.0.0.1:7890",
"http.proxyStrictSSL": false
三、通过系统环境变量设置代理
VSCode 启动时会读取系统级环境变量,此方式对所有基于 Electron 的应用(包括插件安装后台进程)均有效,且无需在 VSCode 内重复配置。
1、打开终端,执行 nano ~/.zshrc(macOS 默认 shell)或 nano ~/.bashrc(Linux 或旧版 macOS)。
2、在文件末尾新增两行:
export HTTP_PROXY=http://127.0.0.1:8080
export HTTPS_PROXY=http://127.0.0.1:8080
3、保存后执行 source ~/.zshrc 使配置立即生效。
4、完全退出 VSCode 并重新启动,确保新环境变量被加载。
四、为 VSCode 桌面快捷方式注入代理参数(macOS)
此方法绕过配置文件与环境变量,直接在启动时传入代理参数,适用于多代理切换或临时调试场景,对当前启动实例生效。
1、在终端中执行以下命令启动 VSCode:
code --proxy-server="http://127.0.0.1:1087"
2、若需同时指定认证信息,可追加参数:--proxy-server="http://user:pass@127.0.0.1:1087"。
3、注意:此方式启动的窗口不会继承 Dock 图标默认行为,建议仅用于测试。










