你有没有遇到过这样的情况:一段 Python 代码运行得莫名其妙的慢,你来回看了好几遍源码都找不到原因;又或者你翻到一个装饰器库的源码,盯着那个 @ 语法看了半天,就是搞不清楚它背后到底做了什么事。这些问题我早年也遇到过。后来我把 Python 标准库里的 dis 模块翻出来研究了一遍,很多“说不清为什么”的疑惑才真正落地。这个模块的作用说起来很纯粹,就是把 Python 函数、方法和代码对象“翻译”成字节码指令,让你看到解释器真正执行的步骤。对于想深入理解 Python 运行机制的人、写性能敏感代码的人、以及被各种魔法语法折磨得想放弃的人,dis 模块都是一把很好用的手术刀。这篇文章我会从零开始,带你把 dis 的输出看懂,再用几个实战案例展示它到底能帮我们解决什么问题。
1. 为什么要去读字节码:那些源码里不会告诉你的答案
1.1 三个“常规操作解释不清”的现象
先聊三个我早年踩过的现象,你大概率也遇到过。
第一个是变量作用域。很多 Python 初学者会问:为什么函数内部访问全局变量比访问局部变量慢?网上答案很多,有人说“全局变量要查字典”,这个说法半对半错,但真要说清楚背后每一步发生了什么,大部分人都说不出来。
第二个是推导式。列表推导式大家都爱用,它比 for 循环快也是广泛流传的说法。但很少有人能解释清楚:为什么推导式有自己的作用域?3.x 版本里,推导式里的变量为什么不会“泄漏”到外部?如果你只看源码,这个行为只能靠猜。
第三个是装饰器。@decorator 这种写法几乎所有人都在用,但 @ 符号背后到底生成了什么代码?装饰器是在定义时执行还是在调用时执行?很多人被问到这里就开始含糊了。
这些问题有一个共同点:源码层面看不到真正的答案,因为解释器执行的并不是你写的 Python 代码,而是编译后的字节码。字节码才是 CPython 真正运行的东西,源码只是它的“前端界面”。
1.2 dis 模块的身份与历史:它就是那本“翻译词典”
dis 是 CPython 标准库中的一个模块,名字来自 disassemble,也就是“反汇编”。它的作用是把代码对象、函数、类、甚至整个模块文件拆解成一条一条的字节码指令,并配上参数、行号等额外信息。
Python 在执行任何代码之前,都会经过一个“编译”阶段。注意,这个编译不是像 C 语言那样编译成机器码,而是编译成中间态的字节码,存到 .pyc 文件里。之后 Python 解释器启动一个叫作“求值循环”的过程,一条一条地读取字节码指令并执行。
dis 模块正是在这个环节上开了一扇窗。它不做任何修改,只是把已经生成好的字节码指令读出来展示给你看。也就是说,你没有给执行过程增加任何额外负担,dis 只是“旁观者”。
从 Python 3.4 开始,dis 模块从纯 Python 重写成了 C 实现,性能大幅提升,输出格式也更稳定。不过它的核心 API 很稳定,几十年来基本沿用同一套设计哲学——把代码对象翻个底朝天给你看。
1.3 初探之前需要知道的虚拟机常识
在真正看 dis 输出之前,有一个背景知识必须交代:CPython 是一个基于栈的虚拟机。
这里的“栈”你可以想象成食堂打菜的柜台。厨师把菜一盘一盘放在柜台上,服务员按顺序取走,取走之后柜台又空出来可以放新菜。字节码执行时,所有运算的中间结果都放在一个操作数栈上。一个加法指令通常的做法是:先把第一个数压栈,再把第二个数压栈,然后加法指令把栈顶的两个数弹出,相加,再把结果压回栈顶。
理解了这个模型,你再回头去看 dis 的输出就豁然开朗。那些 LOAD_FAST、STORE_FAST 之类的指令,本质上都是在“往栈上放东西”或者“把栈上的东西拿去存起来”。Python 里的“一切皆对象”在这个底层也成立,栈上的每一项都是一个 PyObject 指针。
还需要知道一个概念:代码对象。每个函数、每个模块、每个类体,在编译后都是一个独立的 code object。这个对象里保存了指令序列、常量表、变量名表、文件名、行号等一切解释器执行所需的信息。你用 dis 模块去分析一个函数,实际分析的就是它的代码对象。
了解了这些,我们就可以开始动手了。dis 模块真正有趣的地方不是概念,而是实际输出。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 打开 dis 模块的四种方式:总有一种适合你的场景
2.1 dis.dis():最粗暴也最常用的入口
先从一个最简单的函数开始。
python复制import dis
def demo(a, b):
c = a + b
return c
dis.dis(demo)
我本机是 CPython 3.10.x,输出长这样:
code复制 3 0 LOAD_FAST 0 (a)
2 LOAD_FAST 1 (b)
4 BINARY_ADD
6 STORE_FAST 2 (c)
4 8 LOAD_FAST 2 (c)
10 RETURN_VALUE
每一行代表一条字节码指令,含义非常直白:
- 开头的数字是源代码行号,说明这条指令对应源码里的哪一行。
- 第二列是这条指令在当前代码对象里的偏移量,单位是字节。
- 第三列是指令名称,比如 LOAD_FAST、BINARY_ADD。
- 如果指令带参数,第四列是参数,有时还会带括号显示参数对应的实际名字或值。
所以这段输出的意思就是:把局部变量 a 压栈,把局部变量 b 压栈,执行加法并弹回结果,存入局部变量 c,再把 c 压栈,最后返回栈顶值。
这是 dis 模块最常用的入口。dis.dis 可以接收函数、方法、类、模块、代码对象,甚至一个字符串里的 Python 代码。
python复制# 直接传代码字符串
dis.dis("x = [i for i in range(5)]")
这种用法很适合在脚本里快速查看一段代码的字节码。
