问题描述
在使用 VSCode 进行 SSH 远程连接服务器时,如果一直卡在下载 "vscode server" 阶段,通常是由于网络限制导致无法访问官方资源。若使用 MobaXterm 等终端工具可正常连接,则基本确认为网络问题。
方法 1:配置代理
在下载 vscode server 时,若国内网络受限,需要配置代理网络,之后即可正常连接。
方法 2:手动下载部署
如果无法配置代理,可以手动下载 vscode server 包并上传至服务器安装。
步骤 1:获取 Commit ID
在 VSCode 终端输出信息页面,按 Ctrl+F 搜索 "commitId",记录 commitId 后面的一串字符(如下图所示)。

步骤 2:构建下载链接
将记录的 commitId 替换以下 URL 中的变量,并在浏览器中下载 vscode server 包:
https://update.code.visualstudio.com/commit:${commit_id}/server-linux-x64/stable
步骤 3:上传与解压
使用 MobaXterm 或类似远程终端连接服务器,切换到 ~/.vscode-server/bin 目录(若 .vscode-server 在其他位置请切换至对应目录),然后进入 bin 目录。
将本地下载的 vscode-server-linux-x64.tar.gz 传入该目录下,执行以下命令:
tar xzvf vscode-server-linux-x64.tar.gz
步骤 4:重命名目录
执行以下命令替换目录名称,注意将 ${commitid} 替换为第一步记录的 ID:
mv vscode-server-linux-x64 ${commitid}
完成后关闭 VSCode 重新打开连接即可。
方法 3:排查网络环境
如果上述方法仍无法连接,可能是本地或服务器网络环境问题。建议尝试切换 WiFi、使用移动数据或其他网络环境进行测试。有时等待网络恢复后也可自动解决。


