2. print调试法：最原始也最有效的调试方式

说实话，print调试法可能是每个Python开发者最早接触的调试手段。我刚开始写代码那会儿，连IDE的断点功能都不会用，全靠print一招鲜吃遍天。直到现在，在一些特定场景下，我依然会优先选择print——因为它真的够快、够直接。

核心观点：print调试法不是low，而是「快」。在快速验证想法、排查简单逻辑错误时，它比任何调试器都高效。

2.1 print语句的使用技巧

很多人觉得print就是往控制台扔个字符串，其实不然。我见过太多新手在代码里写满print("1")、print("2")，然后对着输出一脸懵——这能看出啥？

真正有效的print调试，要遵循三个原则：

标记位置：明确告诉自己是哪一行输出的
输出变量名+值：别只输出值，要带上变量名
区分不同模块：用前缀区分来自哪个函数或类

# ❌ 反面教材
print(x)
print(y)
# 输出：42  [3, 5, 7]
# 你根本分不清哪个是x哪个是y

# ✅ 正确姿势
print(f"[calculate_average] x = {x}")
print(f"[calculate_average] y = {y}")
# 输出：[calculate_average] x = 42
#       [calculate_average] y = [3, 5, 7]

我个人习惯在print里加上函数名或模块名前缀。这样当项目大了、print满天飞时，一眼就能定位到是哪个模块在输出。

2.2 格式化输出调试信息

Python的格式化输出有好几种方式，我推荐用f-string，它最直观、最不容易出错。但其他方式也得了解，毕竟你可能会遇到老代码。

方式	示例	适用场景
f-string	`print(f"x={x}, y={y}")`	日常调试首选，Python 3.6+
%格式化	`print("x=%d, y=%s" % (x, y))`	兼容旧代码，或需要精确控制格式
.format()	`print("x={}, y={}".format(x, y))`	老项目常见，可读性一般
repr()	`print(f"x={x!r}")`	需要看到对象的完整表示（含引号、转义等）

这里有个小技巧：用 !r 可以输出变量的repr表示。比如字符串带引号、特殊字符被转义，这对调试特别有用。

name = "hello\nworld"
print(f"name = {name}")   # 输出：name = hello
                          #       world
print(f"name = {name!r}") # 输出：name = 'hello\nworld'

为什么会这样？因为普通print会解释转义字符，而repr会展示原始内容。我在调试文件路径时经常用这个技巧，能一眼看出路径里有没有多余的空格或换行。

2.3 条件打印

有时候你不想每次循环都打印，只想在特定条件下输出。比如排查一个只在第1000次迭代才出现的bug，总不能打印1000行吧？

条件打印的核心思路：给print加个if判断。

# 场景1：只打印特定次数
for i in range(10000):
    # 处理逻辑...
    if i % 1000 == 0:  # 每1000次打印一次
        print(f"[进度] 已处理 {i} 条数据")

# 场景2：只打印异常值
for item in data:
    if item < 0:  # 只打印负数
        print(f"[警告] 发现负值: {item}")

# 场景3：使用调试开关
DEBUG = True  # 全局开关
def process(x):
    if DEBUG:
        print(f"[DEBUG] process() 收到 x={x}")
    # 处理逻辑...

我曾经在一个数据处理脚本里，用条件打印定位了一个只在特定日期出现的bug。当时数据量有上百万条，全打印出来根本没法看。我加了个条件——只打印日期为2023-06-15的数据，问题立刻暴露了。

小技巧：可以用 __debug__ 内置常量或 sys.gettrace() 来判断当前是否在调试模式，从而实现自动条件打印。

2.4 print调试的优缺点

任何工具都有两面性。print调试法用得好是利器，用不好就是灾难。我根据自己的经验总结了一下：

优点

零门槛：不需要学任何调试工具，会print就行
无环境依赖：在远程服务器、嵌入式设备、Docker容器里都能用
不影响执行流程：不会像断点那样暂停程序，适合调试长时间运行的任务
可持久化：输出可以重定向到文件，方便事后分析

缺点

污染代码：调试完要记得删掉，否则代码里全是print
性能开销：大量print会拖慢程序，尤其是I/O密集场景
信息有限：只能看到变量值，看不到调用栈、线程状态等
容易遗漏：如果忘记加条件，输出会刷屏，反而淹没了关键信息

注意：千万不要在生产环境里遗留大量print语句。我曾经见过一个同事，把调试用的print带到了线上，结果日志文件一天涨了10个G……嗯，那天的复盘会开得挺久的。

2.5 知识体系一览

下面这张图概括了print调试法的核心要点，你可以把它当作快速参考：

说白了，print调试法就像一把瑞士军刀——不华丽，但关键时刻真能救命。你不需要在每个项目里都用它，但掌握它绝对能让你在调试时多一个选择。

我个人建议：把print调试作为你的「第一反应」调试手段。遇到bug先print两下看看变量值，很多时候问题就水落石出了。如果print搞不定，再上断点调试器也不迟。

避坑指南：我曾经在调试多线程程序时，用print输出共享变量的值，结果发现输出顺序和实际执行顺序对不上。后来才意识到——print本身是线程安全的，但多个线程的print输出会交错在一起。所以调试并发代码时，建议每条print都带上线程ID或时间戳。

好了，print调试法就聊到这儿。记住：工具没有高低之分，只有合不合适。下一节我们会聊聊另一种更「高级」的调试方式——但在此之前，先把print用熟练了再说。

📚 课程目录

2. print调试法：最原始也最有效的调试方式

2.1 print语句的使用技巧

2.2 格式化输出调试信息

2.3 条件打印

2.4 print调试的优缺点

优点

缺点

2.5 知识体系一览