远程服务器离线安装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

官网对vscode更新的相关描述

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 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上下载：https://github.com/Microsoft/vscode-python/releases

5. 总结

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

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