You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在终端运行Python脚本时启动VS Code调试器?

如何在终端运行Python脚本时触发VS Code调试器并命中断点

我完全懂你的需求——平时在VS Code里点调试按钮、设断点特别顺手,但有时候必须从终端启动脚本,还想用上VS Code的可视化断点调试功能对吧?这里有两种亲测好用的方案:

方法一:远程附加调试(通用场景)

这是最灵活的方案,不管你用本地终端还是远程服务器终端都能生效:

  1. 先在VS Code里打开你的项目根目录,创建或修改.vscode/launch.json配置文件,添加一个远程附加的调试配置:
    {
        "version": "0.2.0",
        "configurations": [
            {
                "name": "Python: 远程附加",
                "type": "python",
                "request": "attach",
                "connect": {
                    "host": "localhost",
                    "port": 5678
                },
                "pathMappings": [
                    {
                        "localRoot": "${workspaceFolder}",
                        "remoteRoot": "."
                    }
                ]
            }
        ]
    }
    
  2. 安装调试所需的debugpy包(如果还没装):
    pip install debugpy
    
  3. 从终端启动脚本时,加上debugpy的调试参数:
    python -m debugpy --listen 5678 --wait-for-client /scripts/test.py
    
    其中--wait-for-client会让脚本暂停执行,直到VS Code的调试器连接上来,给你足够时间去启动调试会话。
  4. 回到VS Code,点击左侧调试面板的启动按钮(或按F5),选择刚才配置的Python: 远程附加,就能成功连接到终端中的脚本,命中你提前设置好的断点了。

方法二:VS Code终端快捷调试(本地场景)

如果只是在VS Code内置终端或本地外部终端运行,还有更简便的方式:

  • 如果你还没输入脚本命令:激活你的Python虚拟环境后,直接点击VS Code顶部调试栏的启动按钮(或按F5),VS Code会自动在当前终端窗口中运行脚本并触发调试,断点正常生效。
  • 如果你已经在终端里输入了脚本命令:把原命令替换成这个快捷指令:
    ${command:python.debugAdapter} /scripts/test.py
    
    运行后VS Code会自动唤起调试会话,直接命中你设置的断点。

内容的提问来源于stack exchange,提问作者thehumbling

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.27 09:32:35