断点不生效的根本原因是调试流程未真正启动，需确保debugpy已安装、Python解释器路径匹配且launch.json中"type"、"program"/"module"、"console"三项配置正确。
断点不生效 是最常遇到的问题，根本原因不是“没点对”，而是调试流程根本没真正跑起来。VSCode 只是界面，背后必须有 debugpy 启动、解释器匹配、配置对齐，三者缺一不可。
为什么打了断点却完全不停？
红点只是标记，不是魔法。它要起作用，得满足三个硬性条件：
-
debugpy必须已安装：运行python -m pip install debugpy，别依赖扩展自动装——某些旧版或精简环境会漏掉 - 底部状态栏必须显示 Python 解释器路径（如
Python 3.11.9），且和你项目实际用的一致；如果显示Python (unavailable)或路径明显不对（比如指向系统 Python 而非 venv），justMyCode会静默跳过断点 - 你点的是左侧调试图标里的 ▶️（启动调试），不是右上角 Code Runner 的绿色三角——后者根本不走调试协议，纯执行
launch.json 里哪三项必须立刻核对？
90% 的失败都卡在这三个字段上，其他可后续加：
-
"type": "python"：大小写敏感，不能写成"Type"或"Python" -
"program": "${file}"或"module": "myproject.main"：前者适合单脚本，后者适合包结构；如果你的入口是python -m mypackage.cli，就绝不能用program，否则模块导入失败，断点白设 -
"console": "integratedTerminal"：设成"externalTerminal"在 Windows 上极易因权限/路径失败，先用集成终端保底
调试时变量显示 <optimized out></optimized> 或为空？
Python 本身极少出现这个提示，但如果你用了 Cython 编译的模块、或 PyTorch DataLoader 的 num_workers > 0，子进程默认不继承调试上下文。
- 检查是否启用了多进程：比如
DataLoader(..., num_workers=4)，此时需在launch.json配置中显式加上"subProcess": true - 确认没误开
justMyCode: false后去第三方库里打点——这不会导致空值，但会让调试器卡在import行反复加载，看起来像卡死 - 变量为空更常见于作用域问题：比如你在函数内设断点，但想看全局变量
CONFIG，而它其实在另一个模块里未被导入——Variables 面板只显示当前栈帧可见的符号
条件断点和日志点怎么避免副作用？
右键断点选「编辑断点」输表达式很直观，但容易踩坑：
立即学习“Python免费学习笔记（深入）”；
- 条件表达式只能读，不能改：写
i += 1或print("hit")不仅无效，还可能导致断点失效或跳过 - 日志点里的模板（如
Processing item {item.id}）要求item在当前作用域存在；如果item是循环变量但循环已结束，会报ReferenceError - 命中次数断点（Hit Count）比条件更稳：比如设 “break when hit count is 5”，不依赖变量状态，适合调试循环第 N 次迭代
debugpy 加载、解释器没切错、launch.json 没抄错字段名、以及——你调试的那行，真的被执行到了。 
