如何在VSCode中调试运行JupyterDash应用的.ipynb文件？

一、JupyterDash + VSCode Jupyter 原生调试方案 #

该方案可覆盖你提出的全部6项调试需求，经过实测稳定可用，操作步骤如下：

• 前置配置
  • 升级VSCode官方Jupyter扩展到最新版本，为当前.ipynb文件选择安装了对应版本JupyterDash、Plotly的Python解释器作为内核
  • 初始化Dash app后，启动服务时添加参数关闭自动重载，避免断点失效：

    app.run_server(debug=True, use_reloader=False)
    

• 具体调试操作
  1. 断点设置：直接点击代码行号左侧位置，出现红色断点标记即为设置成功，回调函数内部的代码行也可正常设置断点
  2. 启动调试：不要使用全局「启动调试（F5）」入口，右键需要调试的单元格，选择「调试单元格」，或点击单元格工具栏的调试按钮进入调试模式
  3. 单步/逐行运行：进入调试模式后，常规调试快捷键可正常使用：F10逐行执行跳过函数、F11单步进入函数内部（可进入回调逻辑）、Shift+F11跳出当前函数
  4. 变量检查：调试过程中可在侧边栏「变量」面板的JUPYTER:VARIABLES分区查看所有全局、局部变量值，也可直接悬停在代码变量名上快速查看
  5. 回调调试：启动服务后在打开的Dash页面触发交互操作，即可自动命中回调函数内设置的断点，查看回调执行过程中的所有参数、中间变量
  6. 交互式修改变量：命中断点时，在调试控制台直接输入变量赋值语句即可实时修改当前上下文的变量值，修改后继续运行将使用新值执行后续逻辑

二、替代方案（无需JupyterDash） #

如果需要更高的调试稳定性，可将Dash业务逻辑先写到.py文件中，使用纯Dash原生调试模式：

if __name__ == '__main__':
    app.run_server(debug=True)

直接按F5启动调试即可，断点、单步执行、变量修改等功能的兼容性和稳定性都高于Jupyter环境下的调试，完成逻辑验证后再迁移到.ipynb文件中即可。

内容的提问来源于stack exchange，提问作者vestland