VSCode中debugpy连接被拒（ECONNREFUSED）问题求助

• 确认端口实际被监听
  用系统命令检查5678端口是否真的被目标进程占用：

  • Windows：netstat -ano | findstr :5678
  • macOS/Linux：lsof -i :5678
    确保输出中的进程是运行debugpy脚本的Python进程，避免端口被其他程序抢占。

• 验证DEBUG环境变量生效
  启动脚本时必须明确传递DEBUG=true环境变量，比如在终端执行：

  DEBUG=true python your_script.py
  

  若环境变量未正确设置，debugpy不会进入监听逻辑，自然无法建立连接。

• 对齐VSCode和脚本的Python解释器
  检查VSCode左下角显示的Python解释器路径，和运行脚本时使用的Python路径是否一致（终端执行which python/where python查看）。解释器版本或环境不一致可能导致debugpy兼容性问题。

• 修改监听地址为0.0.0.0
  将脚本中的监听代码调整为：

  debugpy.listen(("0.0.0.0", 5678))
  

  同时把launch.json中的host字段改为"0.0.0.0"，规避localhost解析异常导致的连接失败。

• 排查防火墙拦截
  临时关闭本地防火墙或安全软件，测试是否能正常连接。如果可以，给debugpy或5678端口添加放行规则。

• 更新依赖和插件
  执行pip install --upgrade debugpy更新debugpy版本，同时在VSCode中更新Python插件到最新版，旧版本可能存在已知的兼容性bug。

• 简化配置测试
  暂时移除launch.json中的pathMappings、console等额外配置，使用最基础的attach配置验证：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "name": "Attach to debugpy",
        "type": "python",
        "request": "attach",
        "port": 5678,
        "host": "localhost"
      }
    ]
  }
  

  确认基础配置能正常连接后，再逐步恢复原有配置。

内容的提问来源于stack exchange，提问作者Luís Henrique Martins