必须先按F5启动调试会话,状态栏变橙色后断点才生效;F10跳过函数、F11进入函数、Shift+F11跳出函数;条件断点和日志点可精准控制暂停与输出。

怎么在 VS Code 里真正“一行一行”走代码?
不是运行完看结果,而是让程序停在某一行,你点一下、它动一行——这叫“单步执行”,核心靠断点 + 调试控制键,和是否 Python/JS/C++ 无关,但每种语言的调试器行为有细微差别。
关键不是“能不能”,而是“有没有启动调试会话”。很多人点了 F9 打了红点,然后按 Ctrl+F5 或直接右键“运行 Python 文件”,结果代码飞快跑完,断点完全不生效——因为那根本没进调试器。
- 必须先按
F5(或点击调试图标里的绿色三角形),确保状态栏变成橙色,且调试侧边栏展开 - 断点只在调试会话中起作用;普通运行(
Ctrl+Shift+F10或终端python xxx.py)完全无视断点 - 首次调试 Python 时,VS Code 通常会自动提示选择解释器;选错环境(比如选了系统 Python 而项目用 conda 环境)会导致断点命中但变量为空
F10 / F11 / Shift+F11 到底该用哪个?
这三个键是“一行一行”的操作中枢,但功能差异直接影响你能否看到函数内部逻辑:
-
F10(Step Over):执行当前行,**不进函数**。比如result = calculate(a, b),按F10后直接跳到下一行,calculate内部被当黑盒跳过 -
F11(Step Into):执行当前行,**且进入函数第一行**。同样那行result = calculate(a, b),按F11就会跳进calculate函数体内部,从result = a + b开始继续逐行 -
Shift+F11(Step Out):当前已进入某个函数,想“赶紧出来”,就按它——执行完剩余函数体,停在调用它的下一行
常见误操作:在循环里狂按 F11,结果一路钻进 print() 或 range() 源码(尤其 justMyCode: false 时)。真想跳过内置函数,优先用 F10。
为什么断点打了却不停?检查这三处
红点在那儿,程序就是不暂停——90% 是配置或启动方式错了,而不是 VS Code 坏了。
-
launch.json里"program": "${file}"是默认值,但如果文件依赖命令行参数(如python train.py --lr 1e-3),没在"args"里写进去,脚本可能因参数缺失提前退出,根本走不到断点 - 远程开发(Remote-SSH)时,
python路径必须显式指定,比如"python": "/home/user/anaconda3/envs/myenv/bin/python";只写"python"容易指向服务器默认的旧版本,导致扩展加载失败 - Python 扩展未启用或损坏:检查左下角是否有 Python 图标;若无,重装
ms-python.python扩展;Windows 上杀毒软件有时会拦截调试器进程,临时禁用可验证
想跳过某几轮循环,又不想手动点几十次?
别硬肝。VS Code 支持条件断点和命中次数控制,比加 if i == 10: import pdb; pdb.set_trace() 干净得多。
- 右键断点 → “编辑断点”,输入条件如
i > 5 and i % 2 == 0,只有满足时才停 - 同个菜单里设“命中次数”,填
5表示第 5 次执行到这行才中断,适合调试循环后期状态 - 更轻量的替代:右键断点 → “转换为日志点”,输入
当前 i 值: ${i}, result: ${result},不暂停,只往调试控制台打印——等效于print(),但不污染源码
注意:条件表达式里别写会改变状态的调用,比如 data.pop() 或 cache.clear(),调试器求值顺序不可控,可能引发意外副作用。










