答案:配置vscode调试flask需安装Flask、编写入口文件、在launch.json中设置调试参数,然后设断点并启动调试会话。具体步骤包括创建launch.json文件并配置program、env和args等选项,确保使用正确python解释器,避免端口占用,最后通过运行和调试面板启动应用,在集成终端查看输出并进行单步调试。

使用 VSCode 调试 Flask 应用可以让开发过程更高效。通过合理配置,你可以在编辑器中直接设置断点、查看变量、单步执行代码。下面是如何在 VSCode 中调试 Flask 应用的实用指南。
1. 确保 Flask 和依赖已安装
在开始前,请确认你的项目环境中已安装 Flask,并且可以通过命令运行应用。
app.py 示例:
from flask import Flask
app = Flask(__name__)
@app.route(‘/’)
def index():
return “Hello, Flask!”
if __name__ == ‘__main__’:
app.run(debug=True)
2. 配置 VSCode 调试环境
VSCode 使用 launch.json 文件来定义调试配置。你需要为 Flask 创建一个合适的配置。
操作步骤:
- 打开 VSCode,进入“运行和调试”侧边栏(快捷键 Ctrl+Shift+D)
- 点击“创建 launch.json 文件”
- 选择“Python”环境
- 替换内容为以下配置:
{ “version”: “0.2.0”, “configurations”: [ { “name”: “Debug Flask App”, “type”: “python“, “request”: “launch”, “program”: “${workspaceFolder}/app.py”, “console”: “integratedTerminal”, “env”: { “FLASK_APP”: “app.py”, “FLASK_ENV”: “development” }, “args”: [ “–no-reload” ], “justMyCode”: true } ] }
说明:
- program:指向你的主应用文件,根据实际文件名调整
- console:设为 integratedTerminal 可在终端中看到输出
- env:设置环境变量,启用开发模式
- –no-reload:避免调试器重复启动两个进程
3. 启动调试会话
配置完成后,你可以开始调试。
- 在代码中点击行号左侧设下断点(红点)
- 回到“运行和调试”面板,选择“Debug Flask App”
- 点击绿色启动按钮
- Flask 应用将在调试模式下启动
- 访问 http://localhost:5000,程序会在断点处暂停
此时你可以查看调用栈、变量值、逐行执行等。
4. 常见问题与建议
- 如果出现“Address already in use”,检查是否有其他 Flask 进程在运行
- 若断点未生效,确认 justMyCode 是否设置为 false 来调试第三方库
- 使用虚拟环境时,确保 VSCode 选择了正确的 Python 解释器(Ctrl+Shift+P → Python: select Interpreter)
- 大型项目可考虑使用 flask run 命令配合附加到进程的方式调试
基本上就这些。配置一次后,每次开发都可以直接使用调试功能,提升排查问题效率。不复杂但容易忽略细节。


