VS Code调试Python报错“Timed out waiting for launcher to connect”求助

1. 手动配置单文件调试环境 #

现在单文件调试需要选工作区，说明默认的单文件调试规则失效了，手动建个调试配置就能解决：

• 打开要调试的Python文件所在文件夹，点左侧「运行和调试」面板，选「创建launch.json文件」，再选「Python」环境。
• 把默认配置改成下面这样，专门针对单文件调试：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
            "env": {"PYDEVD_WARN_EVALUATION_TIMEOUT": "10000"}
        }
    ]
}

加的env配置能延长调试器连接超时时间，避免因连接慢触发报错。

2. 核对Python插件的核心配置 #

• 按Ctrl+,打开设置，搜Python: Default Interpreter Path，确认选的是你在CMD里能正常跑脚本的那个Python解释器，别让插件用错了环境。
• 再搜Python: Debugger Path，确保路径指向Python安装目录下Lib/site-packages/debugpy/_vendored/pydevd里的pydevd.py，路径不对就手动指定。

3. 临时关闭安全类软件 #

杀毒、防火墙这类软件可能会拦截VS Code和调试器的连接，先临时关掉试试，要是调试正常了，再把VS Code和Python程序加入信任列表。

4. 重置VS Code用户设置 #

要是之前的设置搞坏了，直接重置：

• 按Ctrl+Shift+P打开命令面板，搜「Preferences: Reset User Settings」确认重置，之后重启VS Code。
• 重置前记得备份settings.json，可以通过「Preferences: Open User Settings (JSON)」打开文件复制备份。

5. 检查调试端口是否被占用 #

调试器默认用5678端口，打开CMD输这个命令查占用：

netstat -ano | findstr :5678

要是有结果，记下PID，去任务管理器结束对应进程，再重新调试。

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