进入正题。
首先为了远程调试，我们需要有一段能长时间执行的 python 代码，以及必不可少的 python 虚拟环境。
我在开发机器上创建一套虚拟环境作为演示。
为了获得在 vs code 配置 python 开发环境需要的信息，我执行了上述两个命令，分别获取当前虚拟环境下的 python 解释器路径和 python 包安装路径。
用 vs code 打开当前目录。然后在首选项中设置当前 workspace 的配置，添加上述两个命令的输出，让 vs code 知道用哪个 python 解释器，去哪里寻找模块做代码索引和补全提示。
不必担心记不住配置的 key，只要正确安装了 python 插件（ext install python），这些配置 key 都是有自动补全的。由于我这里没有安装 <code>pylint</code>，只能把 linting 功能关闭了，不然 vs code 会不胜其烦地提醒我安装 linter。
我们这里说的是远程调试，那么我就需要在别的机器上把我要调试的 python 进程启动起来。正好我手上有一台闲置的 thinkpad，前些日子被我装了 neon 这个发行版来体验最新的 kde，正好可以给我拿来当做 remote server。如果你手上没那么多闲置机器，那么用 docker 或者虚拟机来启动个进程也是可以的，注意做好端口映射也就问题不大。
暴露写作时间系列。从上图可以看到许多关键信息，比如代码部署的位置，虚拟环境部署的位置，服务器的 ip 等等……注意到我在代码最开始的地方就设置了 ptvsd 的调试模式。
代码在远程部署好了，但是还没启动，现在让我们回到 vs code。嗯，进入调试视图（debug view），初始化或者打开调试配置（launch configurations）。如果之前没为当前的 workspace 创建过调试配置，那么 vs code 的 python 插件会从模板帮我们初始化出四种不同的调试配置。但是那些都没什么用，都是为本地调试准备的（本地调试的话有必要用 vs code 么，pycharm 多好），都可以删掉，换成下面这段：
这里面有几个需要根据实际情况修改的参数，比如 <code>host</code> 要写目标进程所在的主机，<code>port</code> 要写目标进程里面初始化 <code>ptvsd</code> 时监听的调试端口，<code>remoteroot</code> 要写远程主机上代码部署的位置的绝对路径，这样 vs code 才能把本地代码文件和远程代码文件匹配起来。
vs code 的配置到这里就基本上告一段落了。接下来就是在服务器上启动进程，然后在 vs code 里启动调试，然后装模作样地下断点，在断点附近对表达式求值……
so far so good. 那么问题来了，如果我不仅仅要调试项目中的代码，我还要调试安装到虚拟环境中的第三方库，能做到吗？比如我要单步进入 <code>requests.get</code> 方法。于是我进入 get 方法，下了断点，然后点下绿色的三角按钮，等待奇迹发生。
然而奇迹并没有发生。
vs code 说它找不到代码。source /private/home/panjiabang/.virtualenvs/remote-debug/lib/python2.7/site-packages/requests/api.py is not available.
虽然不知道为啥 vs code 会去 <code>/private</code> 这个 os x 不知道跟谁学来的目录里找东西，但是我的直觉告诉我，这一定是远程机器上的第三方库的绝对路径和本地机器路径不一致造成的。ptvsd 作为调试服务器，肯定不知道客户端的三方库在哪也不需要知道，老老实实把服务器上三方库的路径给到 debugger，结果 vs code python 插件里的 debugger 也傻傻的不知道做个转换，直接就拿远程的路径到本地去找代码，找得到才怪了。
这明显是 vs code python 插件的设计缺陷啊，好歹提供一个配置，做个 <code>site-package</code> 目录的映射什么的，而且不能是 1:1 的映射，得是 m:n 的映射，因为 python 找模块时用的 <code>sys.path</code> 还是有不少的。不过考虑到我们在部署的时候，实际上会把所有的依赖都打包在虚拟环境的 <code>site-package</code> 目录下，所以大多数场景下，只要映射远程的 <code>site-package</code> 和本地的 <code>site-package</code> 就妥妥的够用了。在没有官方的解决方案之前，我只好将就一下，在本地做个软链，让 vs code 能用远程的路径在本地找到代码。
可算是断点到 requests 里头了，真不容易
不得不说，作为一个图形化调试器，vs code 做得还是很不错，基本上现代调试器该有的功能都有了，比如鼠标悬停在变量上方就显示变量的值，选中变量后右键功能支持求值、观察等等，比起 pycharm 之流不遑多让。但是作为一个 ide 还是太弱了，虽然支持 linting，但是检查出来的 warning 不支持自动修复，局部变量重命名居然会漏掉几处，无法分析类间关系、函数覆盖……
如果我还有闲暇时间，或许会尝试给 vs code python plugin 加上 <code>site-package</code> 目录映射什么的。不过我更想要做的，是给 pycharm 写一个 remote debug 的插件，配合 ptvsd 实现远程调试，毕竟 pycharm 是更加靠谱的 python ide。文本编辑器嘛，用来写写博客，敲点简单的代码片段就挺好，复杂的项目还是交给更专业的程序去帮我节约时间。