python 单步调试flask_使用Visual Studio Code编写调试Python Flask程序

最近由于工作关系，开始写flask web程序，同事有用Vim的，有用PyCharm的。在调研了一通python的编辑器，IDE之后，发现Visual Studio Code相对比较适合我。

VSC有相对较全的功能，比较好看舒服的主题，良好的用户体验(我现在用Mac)，启动速度较快，插件体系强大。现将VSC的安装配置过程记录如下。

前置条件是，python 2.7 已经安装完成，pip也已经搞定。

首先在Microsoft Visual Studio Code 网站上下载安装程序，选择对应的平台，我的是osx的。

安装完成后，启动VSC，按 cmd+shift+P，启动快速命令拦，输入ext ins，就会发现第一个选项是安装插件，点击回车来到插件边栏。或者可以直接点击最左边一列图标最下面那个，也会弹出插件边栏。在插件边栏输入Python搜索，安装Python 0.6.0插件。

安装插件完成之后，点击插件上的重新载入，或者重启VSC，以便于载入插件。至此安装完成，下面开始编辑器配置。

VSC采用了类似Sublime Text的全局->用户->工作区层级配置的概念，后者可以覆盖前者，用户只能编辑用户配置喝工程配置，全局配置都是默认的。有一点VSC做的特别好的是，整个软件的本地化特别好，连配置文件中也都是中文注释。如果鼠标悬浮到用户或者工作区的某项配置上，会有个popup中文显示当前配置项的含义。如果想覆盖并修改全局配置中的某一项，可以悬浮到该配置项上，可以看到文字左边出现了一个铅笔样的图标，点击这个图标即可将这条配置复制到用户或者全局配置中做出修改，做的非常人性化。

比如我的用户配置如下：

{

"workbench.colorTheme": "Material Theme",

"editor.fontSize": 13,

"editor.lineHeight": 18,

"editor.rulers": [80,100],

// 配置 glob 模式以排除文件和文件夹。

"files.exclude": {

"**/*.pyc":true,

"**/*.pyo":true,

"**/.idea":true,

"**/.settings":true,

"**/.vscode":true,

"**/.project":true,

"**/.pydevproject":true

},

"python.linting.pylintEnabled": false,

"editor.fontFamily": "Hack"

}

下载并使用了一个好看的主题Material Theme，字号调大到13，此时默认行高为20，我觉得太大，调整到18，配置文件列表中不显示某些后缀的文件，避免影响视野，同时下载了一个开源程序字体Hack，配置为唯一显示字体。

其中最需要注意的是python.linting.pylintEnabled这个选项，我把pylint关掉了。或许是pylint本身的问题或者是集成的问题，pylint对flask的解析总是时对时错，关闭是最好选择。

对于Flask工程本身的配置，需要添加到工作区配置中。由于我们会经常用到virtual env，所以实际上关键需要配置python命令本身的路径如下(跟具体virtualenv的设置有关)：

{

"python.pythonPath": "${workspaceRoot}/venv/bin/python"

}

到这里，配置已经能够满足python工程的高亮，代码补全等编写功能了，快捷键也可以通过配置文件修改，配合VSC自带的能力，已经基本OK了，下面是Flask Debug的配置。

这点消耗了我相当长时间。官网给提供了两种方式，都可以实现。

第一种适合Flask 0.11及以上版本，因为在0.11版本起，出现了venv/bin/flask文件，配置可以写成：

{

"version": "0.2.0",

"configurations": [

{

"name": "Flask",

"type": "python",

"request": "launch",

"stopOnEntry": false,

"pythonPath": "${config.python.pythonPath}",

"program": "${workspaceRoot}/venv/bin/flask",

"env": {

"FLASK_APP": "${workspaceRoot}/app.py"

},

"args": [

"run",

"--no-debugger",

"--no-reload"

],

"debugOptions": [

"WaitOnAbnormalExit",

"WaitOnNormalExit",

"RedirectOutput"

]

}

]

}

用flask.py文件启动Flask程序，实测可以触发断点。

对于在0.11以下版本的Flask而言，可以采用第二种方式：

{

"version": "0.2.0",

"configurations": [

{

"name": "Python",

"type": "python",

"request": "launch",

"stopOnEntry": false,

"pythonPath": "${config.python.pythonPath}",

"program": "${file}",

"debugOptions": [

"WaitOnAbnormalExit",

"WaitOnNormalExit",

"RedirectOutput"

]

}

]

}

切记！！！ Flask在启动时必须指定 app.run(debug=False)，一定不能开启调试！否则无法命中断点。

调试时启动Flask程序的入口文件即可，也可以将${file}替换为实际的入口文件，这样不用每次都切换到该文件才能开启调试。实测OK。

还有一种可以远程调试的方法：

需要先pip install ptvsd

if __name__ == "__main__":

import ptvsd

import socket

try:

address = ('127.0.0.1', 12345)

s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

s.bind(address)

except socket.error:

ptvsd.enable_attach(None, address=('0.0.0.0', 8000))

manager.run()

在manager.run()或者app.run()之前，加入如上代码，在8000端口开启远程调试(不是http服务的端口！)

比如从shell启动此Flask程序，VSC配置如下，Flask启动好之后启动调试监听在8000端口上即可：

{

"name": "Attach (Remote Debug)",

"type": "python",

"request": "attach",

"localRoot": "${workspaceRoot}",

"remoteRoot": "${workspaceRoot}",

"port": 8000,

"host": "localhost"

}

注意远程和本地的源码路径的前缀必须配置正确！