断点为空心圆或灰色，说明调试器未绑定该行，根本原因是调试链路断裂：需确认f5启动而非code runner、状态栏显示完整解释器路径、launch.json中type（小写"python"）、program/module、console字段配置正确，且三处python路径严格一致。
断点是空心圆或灰色，说明调试器根本没加载到那行
VS Code 行号旁的红点只是标记，不是执行指令。实心●才表示调试器已识别该断点；空心○或浅灰色●代表“未绑定”，即 debugpy 没在目标代码上下文中注册它。这不是代码逻辑问题，而是调试链路断裂。
- 先确认你按的是
F5或调试图标里的 ▶️，不是右上角 Code Runner 的绿色三角——后者只走终端执行，完全不加载debugpy - 检查底部状态栏是否显示完整解释器路径（如
/myproj/.venv/bin/python），而不是模糊的 “Python 3.11.9 64-bit” —— 后者说明解释器没真正选中 - 在调试控制台里运行
import sys; print(sys.executable)，输出路径必须和状态栏、终端里which python的结果完全一致
launch.json 里这三个字段写错，断点基本无效
launch.json 是调试启动的唯一依据，错一个就可能全程静默跳过断点。别纠结其他字段，先盯死这三项：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
-
"type": "python"：大小写敏感，不能是"Type"、"Python"或旧版的"pwa-python" -
"program": "${file}"（单脚本）或"module": "mypackage.cli"（包结构）：二者只能选其一；混用会导致模块导入失败，断点设了也进不去 -
"console": "integratedTerminal"：设成"externalTerminal"在 Windows 上极易因权限/路径失败，先用集成终端保底
断点打了但程序跑完都没停，大概率是代码根本没走到那里
常见假象是“断点失效”，其实是执行路径偏差。调试器不会主动跳进未被调用的函数或未导入的模块。
- 你在
utils.py打了断点，但主入口app.py没import utils—— 断点永远不触发 -
if __name__ == "__main__":块里的断点，只有直接运行该文件时才生效；如果它是被其他模块import进来的，这个块根本不会执行 - 路径含中文或空格（尤其 Windows）：debugpy 会静默失败，把项目移到
C:\dev\myproj这类纯英文无空格路径再试
变量看不到、断点跳过自己写的模块，别急着重装插件
默认 "justMyCode": true 会让调试器跳过所有非工作区代码，包括你自己的 src/utils.py（只要它没被显式作为入口加载）。这不是 bug，是设计行为。
- 想调试
src/utils.py里的函数？把"justMyCode"改成false - 但别对
torch、requests这类第三方库这么做——调试器会在import行反复加载，看起来像卡死 - 多线程场景（如
threading.Thread）下，还需加"subProcess": true，否则子线程断点不会触发
launch.json 里隐含调用的解释器、以及代码运行时 sys.executable 真实加载的路径——差一个字符，断点就失联。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
