如何调试由第三方可执行文件运行的Python脚本？

方案一：pdb远程调试 #

• 在Python脚本的目标调试位置（比如开头）添加以下代码，让脚本暂停并等待调试连接：

  import pdb
  import socket
  
  # 绑定本地5678端口，等待调试连接
  sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
  sock.bind(('localhost', 5678))
  sock.listen(1)
  conn, addr = sock.accept()
  pdb.Pdb(stdin=conn.makefile('r'), stdout=conn.makefile('w')).set_trace()
  

• 当外部可执行文件运行到这段代码时，脚本会挂起。此时打开命令行，执行python -m pdb -c "connect localhost:5678"，就能进入调试会话进行单步调试。

方案二：Visual Studio 2022附加调试修正 #

• 之前附加失败大概率是没选对调试引擎：打开“Attach Process”窗口，找到外部可执行文件的进程后，点击「Select…」按钮，勾选Python调试引擎（而非默认的本机调试），再完成附加操作。
• 确保脚本执行到input()暂停时，进程处于活跃状态，此时再尝试附加成功率更高。

方案三：PyCharm远程调试 #

• 在PyCharm中创建「Python Remote Debug」运行配置，设置本地监听端口（比如5678）。
• 在脚本中添加调试触发代码：

  import pydevd_pycharm
  pydevd_pycharm.settrace('localhost', port=5678, stdoutToServer=True, stderrToServer=True)
  

• 启动PyCharm的远程调试监听，再让外部可执行文件运行脚本，即可自动连接到PyCharm进行调试。

关键注意事项 #

• 保证脚本使用的Python环境和外部可执行文件调用的Python环境完全一致，否则调试工具无法正确识别进程。
• 如果外部可执行文件嵌入了Python解释器，需确认该解释器为标准CPython（大部分嵌入式场景都是），非标准解释器可能不支持调试接口。

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