断点不生效需按五步排查：一查是否用debug模式（虫子图标/shift+f9）；二看断点图标是否实心红点；三核对运行配置中脚本路径、解释器及工作目录是否正确；四启用“attach to subprocess automatically”解决多进程断点丢失；五清理缓存与pyc文件并重建项目。
如果您在PyCharm中设置断点后程序未暂停执行，断点呈灰色空心圆或红色实心但“直通不中断”，则说明调试器未能成功绑定到当前执行行。以下是解决此问题的步骤：
一、确认调试启动模式是否正确
PyCharm 默认绿色三角形按钮为 Run 模式，完全忽略所有断点；必须使用带虫子图标的 Debug 按钮（或快捷键 Shift + F9）才能激活调试器。若误选 Run 配置（如 Run 'main.py'），即使断点为红色实心也绝不会触发。
1、检查右上角运行配置下拉框右侧图标：若为灰色三角形，悬停显示 “Run”，说明当前处于运行模式；
2、点击右侧下拉箭头，选择名称含 Debug 前缀的配置项（如 Debug 'test_login' 或 Debug 'main'）；
3、若使用 pytest/unittest，确保运行配置为 Debug 'pytest in test_xxx.py' 而非 Run 版本；
4、观察控制台输出首行是否含 Connected to pydev debugger 字样，无此提示即未进入调试流程。
二、验证断点是否实际绑定成功
断点图标状态是第一道诊断门：实心红点（●）表示已绑定至字节码；空心红点（○）或带斜杠灰点（⊘）表明 PyCharm 无法将该行映射到真实执行位置，属于绑定失败而非逻辑跳过。
1、检查断点所在行是否为可执行代码：空行、纯注释、def 函数定义行、class 类定义行、if False: 后续块 均自动禁用；
2、右键断点 → “More” → 查看 “Line number” 是否与当前文件实际行号一致，若显示 N/A 或负数，说明源码与编译字节码不匹配；
3、在疑似失效断点处插入内置断点语句 breakpoint()，若该语句可中断而 GUI 断点不能，则确认为 IDE 绑定机制异常。
三、检查 Python 解释器与脚本路径一致性
调试器仅对 Run Configuration 中指定的 Script path 文件及其显式导入/执行的代码生效。若解释器路径、工作目录或脚本路径错配，会导致调试器加载错误代码副本。
1、打开 Run → Edit Configurations → 确认 “Script path” 指向项目内真实入口文件（如 src/main.py），而非临时路径或系统路径；
2、检查 “Python interpreter” 是否指向项目虚拟环境中的 python（如 venv/bin/python），而非系统 /usr/bin/python3；
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
3、终端执行 which python 与 PyCharm 设置中解释器路径比对，二者必须一致；
4、确认 “Working directory” 设置为 $ProjectFileDir$，避免因相对路径解析错误导致模块导入失败。
四、处理多进程与子进程调试缺失
主进程 fork 子进程（如 multiprocessing、Django 开发服务器、Scrapy crawl）时，PyCharm 默认仅附加主进程，子进程中所有断点均被跳过，控制台会输出提示：pydev debugger: New process is launching (breakpoints won't work in the new process)。
1、进入 Settings → Build, Execution, Deployment → Debugger → 勾选 Attach to subprocess automatically while debugging；
2、若使用 multiprocessing，需在主进程启动前添加 multiprocessing.set_start_method('spawn')（Linux/macOS 推荐）；
3、对关键子进程，在其入口函数起始处插入：import pydevd_pycharm; pydevd_pycharm.settrace()；
4、若调试 Flask/Django，启用调试配置中的 Run with Python console 并勾选 Add content roots to PYTHONPATH。
五、清除缓存与重置调试环境
PyCharm 依赖索引与缓存定位断点，损坏的 __pycache__、IDE 缓存或调试器 hook 注入失败均会导致断点识别异常。
1、执行 Build → Rebuild Project 强制重新编译全部 .py 文件；
2、手动删除项目根目录下所有 __pycache__ 文件夹及其中 .pyc 文件；
3、选择 File → Invalidate Caches and Restart → “Invalidate and Restart”；
4、重启后，检查 Settings → Build, Execution, Deployment → Python Debugger 中：Gevent compatible（异步框架必需）、Collect run-time types information for code insight 是否启用。
