远程服务器离线安装vscode及扩展组件

1. 场景

本地（Windows 10）安装了 vscode ，因为环境、资源等都是在服务器上（Ubuntu），因此想要通过vscode远程连接服务器，实现在本地操作服务器的目标。vscode在2019年对上述目标的支持已经很完（sha）善（gua）了，只需要安装几个和 Remote 相关的扩展插件（Extensions）就可以了，可以通过图形界面一键安装，这里不再赘述了，我在前期使用的时候也很顺畅。

后来远程服务器网络出现了一些问题，可以正常本地建立连接，但在使用一些常见的更新管道（pip，wget，apt-get等）时总是会超时致使更新失败。可以简单地认为，“远程服务器只能只能建立内网链接，无法访问外网了”。

本来不耽误使用，内网就内网反正环境啥的都配好了也不碍事，就没管它，直到有一天发现 本地vscode无法连接到远程服务器了 ，核心报错如下：

Waiting for /home/user/.vscode-server/bin/a0479759d6e9ea56afa657e454193f72aef85bd0/vscode-scp-done.flag and vscode-server.tar.gz to exist
...... ......
...... ......
.vscode-server/bin/a0479759d6e9ea56afa657e454193f72aef85bd0: No such > file or directory

2. 问题分析

核心问题是 vscode-server下的某个文件夹不存在 ，看这一大长字符串，猜测是版本号相关的描述。首先查看了一下本地vscode的版本号，Help–>About，发现是1.48.2版本，也就是官网上的最新版本，那么问题就已经定位出来了： windows本地的服务器自动更新版本，而远程服务器并没有进行相应的更新（大概率是因为网络问题），导致服务器和本地vscode —— vscode_server版本不匹配，因而无法成功建立连接。 vscode在不同系统中的更新机制如下图所示，如果本地和服务器的外网网络都十分通畅，可以不用管，否则建议把本地的 update.mode 参数设置为 none，防止本地自动更新导致版本不匹配的问题。

p1

3. 问题解决

手动下载 a0479759d6e9ea56afa657e454193f72aef85bd0 文件夹，并放在报错信息中指定的位置。下载可直接通过链接下载：

https://update.code.visualstudio.com/commit:26076a4de974ead31f97692a0d32f90d735645c0/server-linux-x64/stable

注意： ：根据报错信息，修改上述链接你所需要的commit id，然后再下载，这一步骤更详细的教程可以参照：

注意： 按教程将文件夹放置好后，可能需要给整个文件夹赋读写权限，我这边不赋权限是会报错：

chmod -x -R a0479759d6e9ea56afa657e454193f72aef85bd0
# 我直接赋 root 的全部权限了，如果账号没有root权限可以把-R去掉

4. 手动下载扩展插件（Extensions）

在vscode上主要进行python开发，必不可少的一个库是 Python extension for Visual Studio Code ，有了这个库，我们可以自由地切换和使用远程服务器（或本地）的python环境，并使用语法检查、函数与类的跳转等方便的功能，最新版本的python extension还可以支持在vscode中使用jupyter notebook，简直不要太方便，然而这个库也被我整甭了，原因大致可以描述为我有使用最新版本的强迫症，vscode extension也需要本地和远程服务器的版本对齐，我只能更新本地的python插件，而无法一键更新远程服务器上的python插件。

解决方法和之前的类似，也是 本地手动下载-->传到服务器上-->手动安装 这一套流程。庆幸地是vscode为我们提供了 VSIX的离线安装方式 ，不需要再从源码编译。[官网的描述如下：]

p2.png

我的具体操作是：

• 在本地下载python扩展插件的vsix文件 ms-python-release.vsix ，并上传到远程服务器
• 为服务器上的vsix文件赋权限： chmod -x -R ms-python-release.vsix
• 在vscode中，ctrl+shift+p打开命令行，输入 Extensions: install from VSIX ，选中上一步上传好的 vsix 文件，开始安装
• 重启 vscode，正常使用 python 插件

python extension 的 vsix 文件可以在github上下载：

5. 总结

网上的问答帖（stackoverflow、github）、博客（SCDN等）可以帮助我们快速定位问题并找到解决办法，但最准确的问题定位方式离不开 耐心分析报错信息 ，完整的解决问题则离不开 官方API和教程 。

遇到问题，分析问题，解决问题，记录过程。