PyCharm远程调试内置CGI服务器时Python脚本无法在断点处暂停

这种预设断点无法触发、只能单步调试的情况我之前在类似环境下碰到过，结合你的配置（Windows7 64bit、Python 3.6.4 64bit、PyCharm 5.0.4、pydevd 1.1.1），可以从以下几个方向排查解决：

1. 检查远程调试的路径映射是否正确 #

PyCharm远程调试的核心是本地代码与服务器端代码的路径映射，如果映射错误，PyCharm无法将本地断点关联到服务器上运行的代码：

• 打开PyCharm的Run/Debug Configurations，找到你的Remote Debug配置项
• 切换到Path mappings标签页，确保本地项目中cgi-bin/index.py的路径，和服务器上CGI脚本的实际路径完全对应（比如本地D:\project\cgi-bin\index.py对应服务器C:\xampp\cgi-bin\index.py）
• 如果没有映射项，点击+手动添加对应关系

2. 确保pydevd版本与PyCharm兼容 #

你手动安装的pydevd 1.1.1可能和PyCharm 5.0.4自带的pydevd版本不兼容，这是断点失效的常见原因：

• 先卸载手动安装的pydevd：

  pip uninstall pydevd -y
  

• 使用PyCharm自带的pydevd：找到PyCharm安装目录下的plugins/python/helpers/pydev文件夹，将这个路径添加到你的Python环境的sys.path中，或者直接把该文件夹下的pydevd.py等核心文件复制到你的CGI脚本所在目录，确保脚本调用的是和PyCharm匹配的pydevd版本

3. 验证CGI执行环境的Python路径与调试配置一致 #

CGI脚本可能运行在和你本地调试不同的Python环境中，导致pydevd加载异常：

• 在index.py开头添加以下代码，输出当前Python的路径信息：

  import sys
  print("Content-Type: text/html")
  print()
  print("<pre>")
  print(sys.path)
  print("</pre>")
  

• 访问脚本后检查输出，确认pydevd所在路径已被正确包含
• 同时修改settrace代码，开启日志输出到PyCharm控制台，方便排查错误：

  import pydevd
  pydevd.settrace('127.0.0.1', port=8001, stdoutToServer=True, stderrToServer=True)
  

4. 检查断点的有效性 #

有时候断点本身的设置存在问题：

• 确认断点设置在可执行代码行（不是注释、空行或不会被执行的分支）
• 在PyCharm中查看断点状态：红色实心圆点表示断点启用，灰色表示禁用或未关联到代码
• 右键断点，确认没有设置错误的条件断点（比如条件永远不成立）

5. 调整PyCharm调试器的跳过设置 #

如果PyCharm误将你的脚本识别为库文件，会跳过断点：

• 打开File > Settings > Build, Execution, Deployment > Debugger > Stepping
• 取消勾选Skip library files选项，或者在Do not skip these paths中添加你的CGI脚本所在目录的路径

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