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

VSCode运行Python脚本报错:Timed out waiting for launcher to connect

解决VSCode Python调试超时:"Timed out waiting for launcher to connect"

以下是针对你遇到的问题的可行修复方案,按优先级尝试:

1. 修复终端自动化配置冲突

你的settings.json中terminal.integrated.automationProfile.windows是空对象,这可能导致VSCode无法正确启动PowerShell 7进行调试。将其修改为指向你的PowerShell 7实际路径:

"terminal.integrated.automationProfile.windows": {
    "path": "C:\\Program Files\\PowerShell\\7\\pwsh.exe",
    "args": []
}

替换路径为你本地PowerShell 7的安装位置(可通过在PowerShell中运行$PSHOME获取)。

2. 更新并验证debugpy依赖

调试超时大概率和debugpy组件异常有关:

  • 打开VSCode终端,切换到你的Python环境,运行:
    pip install --upgrade debugpy
    
  • 左下角点击Python版本号,确认选中的解释器和你安装debugpy的环境一致。

3. 重置调试配置

备份当前的launch.json后删除,重新生成默认调试配置:

  • 按Ctrl+Shift+P打开命令面板,输入Python: Create Debug Configuration,选择"Python Debugger: Current File"生成新配置。
  • 新配置生成后,确保"console"参数设为"integratedTerminal"。

4. 排查安全软件拦截

系统更新后,杀毒软件或防火墙可能会拦截debugpy的进程通信:

  • 临时关闭第三方安全软件(如360、Windows Defender防火墙),重试调试。
  • 如果问题解决,将VSCode和Python解释器路径添加到安全软件的白名单中。

5. 重置VSCode用户设置

如果以上方法都无效,备份settings.json后重置设置:

  • 按Ctrl+Shift+P打开命令面板,输入Preferences: Reset Settings,选择重置所有设置。
  • 之后逐步恢复你的个性化配置(如字体大小、终端位置等),避免一次性导入全部设置。

额外排查步骤

  • 手动在外部PowerShell窗口运行调试命令,验证debugpy是否正常工作:
    python -m debugpy --listen 5678 --wait-for-client your_script.py
    
    如果命令能正常执行,说明问题出在VSCode的配置而非debugpy本身。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.18 06:22:20