VSCode调试Jupyter Notebook频繁卡顿，如何正确配置调试环境？

解决默认调试配置无Jupyter选项、"name: 'null' is not defined"错误 #

• 放弃使用Python默认调试配置，直接用VSCode针对Notebook的专属调试入口：打开Notebook后，点击目标单元格左侧的虫子图标（「Debug Cell」按钮），或者通过快捷键Ctrl+Shift+P调出命令面板，执行「Jupyter: Debug Cell」——Python默认launch配置是为.py脚本设计的，适配Notebook会触发兼容性错误。
• 若需手动配置launch.json（非必需），在.vscode/launch.json中添加以下专属配置，替换原有Python默认配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Jupyter Notebook Debug",
            "type": "python",
            "request": "attach",
            "port": 5678,
            "host": "localhost",
            "justMyCode": false,
            "redirectOutput": true
        }
    ]
}

解决「Debug Cell」卡顿、Step Over失效、调试无响应问题 #

• 清理冲突扩展：只保留官方的「Python」和「Jupyter」扩展，卸载其他重复或第三方的Python/Jupyter相关扩展，重启VSCode后再测试调试功能。
• 调整内核调试参数：通过Ctrl+Shift+P执行「Jupyter: Configure Interactive Session」，关闭「Debug Just My Code」选项，同时开启「Redirect Output From Kernel」，避免调试时输出阻塞内核。
• 清理缓存文件：
  • 删除VSCode的Jupyter工作区缓存：找到对应系统的缓存目录（Windows：%APPDATA%\Code\User\workspaceStorage；macOS：~/Library/Application Support/Code/User/workspaceStorage；Linux：~/.config/Code/User/workspaceStorage），删除其中Jupyter相关的文件夹。
  • 清理Jupyter内核缓存：执行命令jupyter clean --all，或通过jupyter kernelspec list找到Python3.9对应的内核路径，删除路径下的缓存文件。
• 降级ipykernel版本：最新版ipykernel可能与Python3.9存在兼容性问题，执行命令pip install ipykernel==6.25.0降级，之后重启Notebook内核。
• 关闭VSCode硬件加速：在「文件→首选项→设置」中搜索「Window: Enable GPU Acceleration」，设置为false，避免显卡驱动与GPU加速的冲突导致界面卡顿。

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