如何利用Python pprint模块在调试时清晰地打印复杂的嵌套结构?

大晨姑娘_4373

大晨姑娘_4373

2026-06-09

380人浏览

原创

pprint比print更适合看嵌套数据,因其自动换行、缩进对齐、字典键默认字母排序,使层级结构一目了然;支持width、indent、depth等参数精细控制输出,并能处理任意python对象(含循环引用),而print仅单行输出、无格式化能力。

如何利用python pprint模块在调试时清晰地打印复杂的嵌套结构?

pprint 为什么比 print 更适合看嵌套数据

直接用 print() 打印 dict 套 list 再套 dict,往往挤成一行、缩进混乱、键值对对不齐,根本看不出结构。而 pprint(pretty-print)专为可读性设计:自动换行、缩进对齐、按字母序排字典键(默认),让嵌套层级一目了然。

它不改变数据,只改变输出格式——这点和 json.dumps(..., indent=2) 类似,但 pprint 能处理任意 Python 对象(包括自定义类、函数、循环引用),json 则只认基本类型且会报错。

控制缩进、宽度和深度的关键参数

pprint 的核心是 pprint.pprint() 函数,三个常用参数直接影响调试体验:

  • width:单行最大字符数,默认 80。调大(如 width=120)可减少不必要的换行,尤其适合宽屏终端
  • indent:每级缩进空格数,默认 1。设为 indent=4 更符合 PEP 8 风格,和代码缩进一致
  • depth:限制打印深度,超出部分显示为 [...]。调试超深嵌套时加 depth=3 能快速聚焦顶层结构

示例:

from pprint import pprint
data = {"users": [{"id": 1, "profile": {"name": "Alice", "tags": ["dev", "py"]}}, {"id": 2, "profile": {"name": "Bob"}}]}
pprint(data, width=100, indent=4, depth=2)
输出中 "profile" 字典会被折叠成 {...},避免刷屏。

避免意外排序导致的调试干扰

pprint 默认对字典键排序(sort_dicts=True),这会让原始插入顺序消失。如果业务逻辑依赖键序(比如某些 API 响应或配置字典),排序后可能掩盖问题。

python-pro
python-pro

高级 Python 特性、异步编程、性能调优、静态类型、内存管理、Python 内部机制及生态库方面的专家。

下载

解决方法很简单:

pprint(data, sort_dicts=False)
Python 3.8+ 支持该参数;旧版本需用 pprint.PrettyPrinter(sort_dicts=False).pprint(data)。

注意:即使关掉排序,pprint 仍会把 dict 和 set 显示为花括号形式,别误以为是 JSON——它原样保留 Python 语法特征(比如 True 不是 true)。

什么时候不该用 pprint?

不是所有场景都适合:

  • 需要复制粘贴到 JSON 文件或 HTTP 请求体时,用 json.dumps(obj, indent=2) 更稳妥(pprint 输出含单引号、None、True 等非 JSON 语法)
  • 日志中长期存档结构化数据时,避免用 pprint——它输出带空格缩进,解析困难;改用 repr() 或序列化格式
  • 对象含大量不可序列化内容(如文件句柄、线程锁)时,pprint 可能卡住或抛 RecursionError,此时先用 vars(obj) 或 obj.__dict__ 提取关键字段再打印

真正要盯住的是:你此刻想确认什么——是结构形状?键名拼写?还是某一层的具体值?选工具前先问清楚这个,比记住所有参数更重要。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

全能打印神器
全能打印神器

全能打印神器是一款非常好用的打印软件,可以在电脑、手机、平板电脑等设备上使用。支持无线打印和云打印,操作非常简单,使用起来也非常方便,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1711

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4344

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1689

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

25337

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3087

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3107

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1163

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2423

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程