如何解决VSCode在远程服务器上无法下载或安装插件的网络错误-VSCode-PHP中文网

根本原因是远程服务器上的vscode-server无法访问公网插件市场，因其默认直连marketplace.visualstudio.com且不继承shell环境变量；必须通过~/.vscode-server/data/machine/settings.json配置http.proxy才生效。

如何解决vscode在远程服务器上无法下载或安装插件的网络错误

根本原因不是 VSCode 本身，而是远程服务器上运行的 vscode-server 进程无法访问公网插件市场。它默认走服务器本地网络直连 marketplace.visualstudio.com，而多数生产服务器禁止出向 HTTPS 流量或需走代理。

别在远程终端里手动运行 code --install-extension —— 这调用的是服务器本地未初始化的 VS Code CLI，和 Remote 模式无关
真正起作用的是你本地 VS Code 发起的下载请求，但二进制包最终由远程 vscode-server 解压并加载，所以下载链路必须通到服务器端
验证方法：SSH 登录服务器后执行 curl -I https://marketplace.visualstudio.com，若返回 Failed to connect 就是网络卡点

Remote 场景下，VSCode 客户端的全局 http.proxy 设置（在 Settings UI 或 settings.json）只影响本地进程，不透传给远程 vscode-server。必须显式告诉远程服务用哪个代理。

在远程服务器的用户目录下创建/编辑 ~/.vscode-server/data/Machine/settings.json（注意路径含 Machine，不是 User）

写入：

{"http.proxy": "http://your-proxy:8080", "http.proxyStrictSSL": false}

适用于完全无外网、或代理策略极严的环境。核心是把插件文件（.vsix）手动传到服务器，并让 vscode-server 识别为已安装。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在能上网的机器上，从 marketplace 页面找到「Download Extension」链接，得到 ms-python.python-2024.2.0.vsix 这类文件
用 scp 传到远程服务器任意位置，例如 ~/extensions/python.vsix
在 VSCode 本地窗口按 Ctrl+Shift+P（Mac 为 Cmd+Shift+P），运行命令：Extensions: Install from VSIX...
选择本地路径——VSCode 会把该 .vsix 上传到远程 ~/.vscode-server/extensions/ 并解压，之后立即生效

vscode-server 是由 SSH 启动的独立进程，不继承 shell 环境变量，也不读系统级代理配置。它只认自己配置文件里的 http.proxy，或你显式通过 code --proxy-server 启动（但 Remote 模式不支持该参数）。

不要试图在 /etc/environment 里加 http_proxy —— vscode-server 不加载它
不要在 ~/.bashrc 里 export 代理变量 —— SSH 的 non-interactive shell 不 source 这个文件
唯一可靠的配置入口就是 ~/.vscode-server/data/Machine/settings.json
如果服务器有 iptables/nftables 限制，记得放行代理端口（如 8080）和目标域名 marketplace.visualstudio.com:443