Python 3.14新增断点指令参数配合PDB跳转意外实现GoTo

码农高天

通过在breakpoint中传入包含PDB jump的预设命令列表，开发者能在调试阶段跳过指定逻辑乃至直接跳出多层循环，实现等同于GoTo的跨行跳转效果。

AI-assisted summary of 关于我上周给Python3.14加了goto这件事 — original source. Check the original for full context.

Source published: 2024-10-06

Key ideas

高天在 Python Core Dev Sprint 期间为 Python 3.14 的内置 breakpoint() 函数合入了 commands 参数，允许传入预设的调试器命令列表以实现自动化调试。 (0:00)
结合 PDB 现有的 jump 指令，breakpoint(commands=['n', 'jump 行号', 'c']) 可在代码执行时自动跳过指定逻辑，间接实现了原生 GoTo 语法的效果。 (3:00)
该技术主要用于 Debug 阶段临时绕过耗时或报错逻辑，高天明确强调切勿在生产环境中使用此方法来编写业务代码。 (5:00)

Detailed notes

## Background 该视频由 Python 核心开发者“码农高天”于 2024 年 10 月 6 日发布在 YouTube 平台。视频简介幽默地调侃自己“一不小心就给 Python 加了 goto”，并将这个新秘密分享给观众使用。

## TL;DR 高天分享了自己在 Python Core Dev Sprint 期间为 Python 3.14 合并的一项新特性：为内置的 `breakpoint()` 函数增加了 `commands` 参数，允许开发者以列表形式预设自动执行的 PDB 调试命令。令人意外的是，另一位核心开发者指出该特性若与 PDB 内置的 `jump` 命令结合，便能让代码在运行时直接跨行跳转，变相实现了“原生 GoTo”机制。高天演示了跳过函数中间计算和直接跳出多层嵌套循环的骚操作，并严肃声明这纯属调试层面的奇技淫巧，绝对不能写入生产环境，但在排查特定 Bug 时能大幅提高跳过繁重逻辑的效率。

## Atmosphere & style 视频整体轻松诙谐、充满程序员式的极客幽默。高天带病出镜但讲起硬核技术时依然兴致勃勃，叙述节奏轻快流畅，从介绍调试痛点的严谨专业，逐渐转变为发现“意外实现了 GoTo”时的惊喜与调侃。面对可能被滥用的“邪门”用法，他一边兴致盎然地展示跨行跳转的离谱效果，一边求生欲极强地反复做出免责声明，营造出一种既充满硬核干货又极具戏剧反差的趣味观感。

## Bulletin - [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) 高天在 Python Core Dev Sprint 期间为 Python 3.14 的内置 breakpoint() 函数合入了 commands 参数，允许传入预设的调试器命令列表以实现自动化调试。 - [03:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=180s) 结合 PDB 现有的 jump 指令，breakpoint(commands=['n', 'jump 行号', 'c']) 可在代码执行时自动跳过指定逻辑，间接实现了原生 GoTo 语法的效果。 - [05:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=300s) 该技术主要用于 Debug 阶段临时绕过耗时或报错逻辑，高天明确强调切勿在生产环境中使用此方法来编写业务代码。

## Key takeaways - [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) 逐行修改变量的函数在排查问题时，传统 print 大法存在添加与删除极其繁琐、污染代码的痛点。 - [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) 常规 Debugger 虽能单步排查，但更换不同输入测试时需要退出并机械重复敲击 next 和 print 命令。 - [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) 以往通过 .pdbrc 配置文件执行固定调试命令不够直观，缺乏源码级别的灵活性。 - [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) Python 3.14 扩展了 breakpoint(commands=...)，允许开发者直接传入字符串列表在命中断点后自动顺序执行命令。 - [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) 利用 Python 原生列表特性，可通过列表乘法快速批量生成重复调试指令，如 ['n', 'p x'] * 5 + ['c']。 - [03:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=180s) PDB 内置的 jump 命令允许在暂停时直接将指令指针强行跳转到当前函数内的任意目标行数。 - [03:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=180s) 通过在 commands 中串联单步、jump 与 continue 命令，实现了无需修改逻辑即可跨行执行代码的效果。 - [03:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=180s) 该跳转机制甚至可用于内层循环快速跨越整个双层 for 循环，直接跳出至外层后续代码。 - [05:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=300s) 该功能本质属于技术巧思而非语言规范鼓励的特性，高天郑重声明切勿将其引入生产环境。 - [05:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=300s) 在实际 Debug 场景中，该配合为临时绕过耗时分支或已知报错代码提供了极大的便利。

## Detailed walkthrough ### [00:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=0s) 痛点与破局：给 Python 3.14 的 breakpoint 增加 commands 参数

高天开篇提到，自己上周去参加了 Python Core Dev Sprint，活动结束回来后就感冒了，因此声音状态听起来不是特别好。但他依然坚持录制视频，想要分享自己在 Core Dev Sprint 期间为 Python 3.14 合并（merge）的一个全新特性。他展示了一个自己编写的示例函数：在日常编程中经常会遇到类似的代码，连续多行都对同一个变量（例如 $x$）执行了较为关键的修改操作。当需要排查调试这个函数时就会面临一个难题——这几行代码对变量的改变都很关键，每一行执行后的结果都至关重要，仅凭最终结果根本无法判断到底是哪一行之后开始出现了异常。

如果采用传统的“print 大法”，开发者就必须在每一行后面手动补上一句 `print(x)`。这种做法加的时候费劲，排查完删的时候也费劲；要是只想临时关闭输出，还得把它们一行一行全注释掉，显得非常繁琐笨拙。这时最适合介入的工具自然是 Debugger（调试器）。开发者可以在函数开头设置一个断点，进入调试器后反复单步步进并打印 $x$。这种方式虽然不需要大改源码，想临时切换也只需注释一行断点代码，但又会带来新的折磨：如果调试到一半发现输入为 0 时没有问题，想换一个输入（比如测试输入 100 或者 1000）看看情况，就必须退出 Debugger，修改源码中的调用参数，再重新启动 Debugger；而一旦重新运行，就又得在交互终端里机械地重复敲入一长串命令，诸如反复输入 `n`（next）、`p x`（print x）。

```mermaid flowchart TD accTitle: breakpoint commands execution flow accDescr: 展示了在断点中预设命令列表后，Debugger 自动顺序执行命令并退出的流程。 subgraph Setup["源码设置阶段"] A["调用 breakpoint(commands=[...])"] end subgraph Execution["调试器自动执行阶段"] B["命中断点并暂停"] C["自动执行列表命令: 'n' (单步)"] D["自动执行列表命令: 'p x' (打印)"] E["自动执行列表命令: 'c' (继续运行)"] end A --> B B --> C C --> D D --> E ```

针对这个痛点，高天指出：“在众多的 PDB 命令里面，其实在你设置断点之后你是想执行一些固定的命令的，你在 debug 的时候你这个函数可能会接到不同的输入，你都想在这块 break 一下然后做一些 debugger level 的操作。”以往虽然可以勉强借助 `.pdbrc` 配置文件来实现，但这显然属于不够直观的“邪门外道”。为此，高天在 Python 3.14 中直接给内置的 `breakpoint()` 函数扩展了一个新的实参 `commands`。开发者可以直接传入一个列表（list），里面装入断点触发后希望 Debugger 自动执行的全部指令，例如 `['n', 'p x', 'n', 'p x',..., 'c']`。如此一来，程序不仅在单次运行中自动按步骤打印出每一行执行前后的变量值，开发者更换测试输入时也完全不必重复敲击调试命令。

- `commands` 参数接受一个字符串列表，定义进入断点后自动跑完的一系列调试器指令。 - 借由列表这一原生 Python 数据结构，开发者可以玩出很多进阶花样，例如通过列表乘法 `['n', 'p x'] * 5 + ['c']` 批量生成重复命令，甚至可以在打印命令里直接使用包含 f-string 语法的表达方式。 - 该功能在源码级别提供了一种非常符合 Python 习惯（Pythonic）的内嵌调试指令机制。

[03:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=180s) 意外的化学反应：通过 PDB jump 在 Python 中实现“原生 GoTo”

讲到这里，高天解释了为什么视频标题会叫“给 Python 3.14 加了 goto”。他坦言自己刚设计这个特性时，纯粹觉得它是一个方便排错的 debugging 小工具，完全没料到能跟 GoTo 扯上半点关系；虽然好用，但也谈不上给 Python 带来什么天翻地覆的质变。直到这个 PR 被正式 merge 进主分支之后，另一位核心开发者 Brandt Bucher 跑过来跟高天说：“嘿，你给 Python 加了 goto 啊。”高天一开始还很纳闷，心想自己明明没加，随后才猛然领悟其中的玄机。

原来，在 PDB 现有的内置命令中存在一个极其邪性（evil）的操作叫做 `jump`。它允许开发者在 Debugger 暂停时，强行将执行指令指针直接跳到当前函数内部的任意指定行数。而一旦这个指令与 `breakpoint(commands=...)` 结合在一起，就会产生戏剧性的质变：开发者完全可以直接在自己的函数代码中埋入一个断点，命令调试器跳过中间的多行逻辑，直接落地到后续的目标行并继续运行。从某种意义上说，这直接让 Python 拥有了官方运行机制原生支持的 GoTo 语法能力。

高天在屏幕上进行了实例演示：在函数内部设置 `breakpoint(commands=['n', 'jump 7', 'c'])`。当传入输入参数 500 时，代码进入函数触发断点，先单步执行了一次 `next`（高天解释说这里为什么必须要先执行一步 `next` 的原理比较复杂，视频中暂且不展开细讲），随后通过 `jump 7` 指令直接跳跃到了第 7 行的 `return x`，最后跟上 `continue`。整个过程瞬间跨过了原本排在第 3、4、5、6 行的中间运算逻辑，输入 500 直接不经改动地原样返回。高天进一步展示，这种技巧甚至可以用来轻松应对双层 `for` 循环的跳出：在内层循环中埋下带有跳转指令的断点，可以直接跨越整个多层嵌套跳到外层，让未满足条件的迭代彻底被绕开。

[05:00](https://www.youtube.com/watch?v=tCs6rWpI0IM&t=300s) 免责声明与调试真香场景

在展示完这套惊艳又“离谱”的骚操作后，高天立即给观众打了一剂预防针。他明确强调这只是一种“在某种程度上”实现的技术奇观，绝对不应该在实际的生产环境代码（Production Code）中使用。

面对观众可能产生的误解，高天郑重其事地澄清了视频的初衷：“这期视频既不是鼓励大家用GoTo也不是教大家怎么在Python里面使用GoTo，只是告诉大家我恰好在Python里面做出来了一个GoTo。”他提到平时一般不需要专门做这类免责声明，但鉴于以往某些视频评论区部分观众的理解偏颇，这次有必要先把立场解释得清清楚楚。

不过话锋一转，高天也为这个由新特性衍生出的“GoTo 技巧”正名：在纯粹的 Debug 场景下，它其实具有相当切实的实战价值。在实际排查复杂 bug 时，开发者经常会遇到临时想要跳过某一段容易报错、或者极其耗时的特定代码分支的需求，而在以往往往得靠频繁修改源码或者在命令行里手动操作。现在借助 Python 3.14 中 `breakpoint(commands=...)` 与 `jump` 的配合，原生 PDB 就能以声明式的方式轻松完成代码跳跃测试。最后高天透露，在这次 Core Dev Sprint 中他还给 PDB 贡献了其他新功能，后续有机会再慢慢录视频向大家细致讲解。

## Mentioned 码农高天, Python, Python 3.14, PDB, Brandt Bucher, Python Core Dev Sprint

## Video description 我怎么一不小心就给Python加了goto呢！行啦，秘密告诉你们，你们用去吧！

[Source](https://www.youtube.com/watch?v=tCs6rWpI0IM)

中文简报

Python 3.14新增断点指令参数配合PDB跳转意外实现GoTo 通过在breakpoint中传入包含PDB jump的预设命令列表，开发者能在调试阶段跳过指定逻辑乃至直接跳出多层循环，实现等同于GoTo的跨行跳转效果。高天分享了自己在 Python Core Dev Sprint 期间为 Python 3.14 合并的一项新特性：为内置的 `breakpoint()` 函数增加了 `commands` 参数，允许开发者以列表形式预设自动执行的 PDB 调试命令。令人意外的是，另一位核心开发者指出该特性若与 PDB 内置的 `jump` 命令结合，便能让代码在运行时直接跨行跳转，变相实现了“原生 GoTo”机制。高天演示了跳过函数中间计算和直接跳出多层嵌套循环的操作，并严肃声明这纯属调试层面的技巧，绝对不能写入生产环境，但在排查特定 Bug 时能大幅提高跳过繁重逻辑的效率。高天在 Python Core Dev Sprint 期间为 Python 3.14 的内置 breakpoint() 函数合入了 commands 参数，允许传入预设的调试器命令列表以实现自动化调试。 (0:00) 结合 PDB 现有的 jump 指令，breakpoint(commands=['n', 'jump 行号', 'c']) 可在代码执行时自动跳过指定逻辑，间接实现了原生 GoTo 语法的效果。 (3:00) 该技术主要用于 Debug 阶段临时绕过耗时或报错逻辑，高天明确强调切勿在生产环境中使用此方法来编写业务代码。 (5:00)

Reading summary

Python 核心开发者高天在 Python 3.14 的 Core Dev Sprint 期间为内置函数 `breakpoint()` 引入了 `commands` 参数，不仅解决了多步调试中重复敲击交互指令的痛点，还意外让开发者能结合 PDB 的 `jump` 指令在 Python 中实现原生形式的 GoTo 操作。传统调试痛点与 commands 参数的引入 (0:00) 在日常排查连续修改关键变量的代码时，传统调试方式面临两难：插入大量的 `print()` 会导致清理和临时切换极其繁琐；而在调试器中使用单步步进与打印指令，一旦更换测试输入（例如从 0 切换到 100 或 1000），开发者就必须重启调试器并在交互终端中机械地重复敲入 `n`、`p x` 等命令。以往通过 `.pdbrc` 配置文件预设命令的方式不够直观。针对该问题，高天在 Python 3.14 的 `breakpoint()` 中扩展了 `commands` 参数。该参数接收一个字符串列表，定义进入断点后调试器自动顺序执行的命令流，例如 `['n', 'p x', ..., 'c']`。开发者可以利用原生 Python 列表的特性（如列表乘法 `['n', 'p x'] * 5 + ['c']` 或 f-string）批量构造指令，既无需大改业务代码，也避免了更换输入后的重复按键负担。结合 PDB jump 实现原生 GoTo 机制 (3:00) 该特性合并入主分支后，核心开发者 Brandt Bucher 提醒高天这实际上为 Python 引入了 GoTo。这是因为 PDB 原本内置了 `jump` 指令，允许指令指针直接跳转到当前函数内的任意行；当此能力与 `breakpoint(commands=...)` 结合后，开发者可以在代码中直接预埋跳转逻辑。高天演示了具体用法：在函数内部设置 `breakpoint(commands=['n', 'jump 7', 'c'])`，程序进入函数后先单步执行一次 `next`，随即通过 `jump 7` 跳到第 7 行的 `return x` 并继续运行，从而绕过了原本排在第 3 至 6 行的运算逻辑。该技巧还能用于跳过多层嵌套结构，例如在内层 `for` 循环中放置带有跳转指令的断点，直接越级跳出到外层循环。生产代码禁令与调试场景的实战价值 (5:00) 高天明确强调，通过断点指令实现 GoTo 属于一种特定运行机制下的技术奇观，绝对禁止在实际的生产环境代码（Production Code）中使用。他澄清视频初衷既非鼓励也非教学在 Python 中编写 GoTo 逻辑，而是介绍这个新功能衍生出的技术巧合，以防止观众产生误解。但在纯粹的调试排错环节，这套组合具备实战价值。当开发者需要临时跳过某段耗时极长或容易报错的分支逻辑时，可以直接以声明式的方式跳跃执行，而无需频繁对业务源码动刀或手动干预命令行。此外，高天透露本次活动中他还为 PDB 贡献了其他新特性，后续将另行讲解。该改动在保持 Pythonic 体验的同时大幅提升了 PDB 的自动化调试效率，虽然其衍生出的 GoTo 机制严禁用于生产环境，却为排查特定缺陷与跳过异常逻辑提供了灵活的声明式调试手段。

Original transcript

[0:00] 上周去了Python Core Life 3 然后回来就感冒了大家应该能听出来现在声音状态不是很好但是我们视频还没做对吧所以今天呢就介绍一个在CoreLiveSpring期间我merge了一个给Python3.14写的feature好我们左边有一个函数啊这个函数呢是我自己瞎编的但我们编程中会经常遇到这种代码就连续好多行啊都有比较重要的改变值的操作那当我们debug这个函数的时候呢就会出现一个问题就是这几行的改变我可能都关心每一行之后X结果对于我来说都重要我没有办法判断到底是哪行之后出了状况如果我们使用print的大法就得写成这样对吧每一行后面加一个printx家的时候也费劲山的时候也费劲如果我们想临时拿掉这个print 只能把它们都给注视掉这个显然稍微有点蠢对吧那这个时候的实际上就很适合debugger来发挥作用了我们可以在这个函数里面设置一个断点然后我们可以在第八个里面啊不断的布进然后打印这个 x这个方案的好处啊不太用改source code想要临时切换的时候也是注尸一行就可以了就是我可能debug到这的时候意识到哎输入是零的时候没什么问题我需要换一个输入我可能要看看F100或者F1000对不对那这个时候我就只能退出Debugger,改完Source Code,然后重新Debug,在重新debug的时候我就又要输入一遍这些命令什么 npx npx npx那我相信如果你平时用PDB用的比较多,这是一个你经常会遇到的问题。就是在你设置断点之后其实你是想执行一些固定的命令的你在debug的时候你这个函数可能会接到不同的输入你都想在这块break一下然后做一些debugger level的操作不管你是在设置断点打印或者是做Display这些高级功能那现阶段的PDB呢你有可能可以用PDBRC来勉强实现这个事情但是这显然属于邪门外道对吧我们可能希望的是在插入这个断点的时候直接就告诉这个断点停住之后执行什么命令那我这次实现的呢就是这个功能我呢给breakpoint这个函数增加了一个argument command你可以给这个command argument一个list这个list是你在break之后所有想要执行的命令那这里我们给的非常简单就是下一行打印X下一行打印X下一行打印X然后最后一个continu结束我们可以看我们运行完之后就把每一行运行之前X的值都打印出来了这个时候我们可以很轻松的换一个输入啊比如换成-100然后运行同样的程序就可以看到X在F函数里每一行的变化了那当然由于这个command本身就是一个list所以你可以干一些比较fancy的事情比如说我们懒得打那么多面一样的东西啊我们就把这个List乘以5再加上一个C我们在Print里呢还可以用FStream可以看到出来结果就是这样的这个功能本质上是提供了一个非常方便的在断点上内嵌命令的方式他让你可以在原代码级别以非常拍档的方式提前决定这个断点上要跑哪些命令好那肯定有的人问了对吧说你说了这么半天为什么跟你的题目一毛钱关系都没有呢因为我设计这个feature的时候也没想到能跟我这个题目产生关系这本来就是一个debugging的feature说方便那挺方便但你要说真给Python带来了什么质的改变,那也没有直到这个PR merge完之后啊,Brand找到我跟我说,说嘿,你给python加了go2啊。我也行自我没家呀后来我意识到,哦,还有这么一个事儿在众多的 PDB 命令里面有一个非常 evil 的命令叫做 jump他允许你在debugger里面跳到这个函数的某一行这不就是沟兔吗而配合上我这个feature,理论上你就可以通过breakpoint在你自己的函数里面实现一个官方支持的原生沟通了我们看这里进入F之后我们打一个断点然后首先我们要跑一下next为什么要有这个next需要解释的比较长啊我们在这就不解释了然后我们 jump 到第七行也就是return x接着我们continue我们看在输入是500的情况下函数F直接返回了一个500也就是在这里啊他跳过了3456行直接运行了第7行Return X相似的比如说你现在有一个双城的Floom你也可以通过这种机制直接跳出两个佛路啊跳到外面来我们可以看到没有触发然后这个 aj 分别是零和五所以从某种程度上我确实是让这个Python3.14的官方版本支持了GoTo [5:00] 这也只是某种程度上对吧那很明显你不应该在production code上面用它我一般不会强调这个事啊但是在上次某一期视频之后我发现我们有一小部分观众这个理解能力相对差一点所以我们就说清楚这期视频既不是鼓励大家用GoTo也不是教大家怎么在Python里面使用GoTo只是告诉大家我恰好在Python里面做出来了一个GoTo但是呢这个GoTo在你实际debug的过程中他还真有可能有的时候会有作用因为我们确实有在debug的时候想跳过某一段代码的需求这个事并不罕见对吧那现在你用原生的PDB就可以做到了那这次Sprint呢还给PDP做了一些其他的feature啊有机会慢慢给大家讲好那这期视频这里喜欢的话记得关注热旺旅见三流字幕志愿者杨茜茜

Python 3.14新增断点指令参数 配合PDB跳转意外实现GoTo