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是否正常工作:
如果命令能正常执行,说明问题出在VSCode的配置而非debugpy本身。python -m debugpy --listen 5678 --wait-for-client your_script.py
内容的提问来源于stack exchange,提问作者ElectroCoding
相关产品推荐
相关产品推荐

