0

0

如何让异常在 str 中显示多行格式化信息

冷炫風刃

冷炫風刃

发布时间:2026-01-27 17:51:18

|

387人浏览过

|

来源于php中文网

原创

traceback.format_exc() 是获取当前异常完整多行字符串的最直接方法,返回含类型、消息、文件位置及调用栈的格式化文本,须在 except 块中调用,末尾自带换行。

如何让异常在 str 中显示多行格式化信息

Python 中 traceback.format_exc() 是最直接的多行异常字符串

想把异常变成带换行、缩进、堆的可读字符串,不用自己拼接。标准库traceback 模块专干这事:traceback.format_exc() 会捕获当前异常(即 sys.exc_info() 的内容),返回完整多行字符串,包含异常类型、消息、文件位置和每层调用栈。

常见错误是直接用 str(e)repr(e) ——它们只输出异常消息或简单对象表示,完全不带堆栈。

  • 必须在 except 块内调用,否则返回空字符串
  • 若需格式化特定异常对象(非当前活跃异常),用 traceback.format_exception(type, value, tb)
  • 返回值末尾自带换行,打印时注意别额外加 \n 导致空行

logging.exception() 自动记录多行异常日志

如果目标是写入日志而非拼字符串,logging.exception() 比手动调用 format_exc() 更稳妥。它等价于 logger.error(..., exc_info=True),自动附加完整堆栈,且兼容各种 handler(如文件、SysLog)。

容易忽略的是:它只在 except 块中生效;若在 finally 或函数末尾调用,exc_info 已丢失,只会打空堆栈。

  • 无需 import traceback,减少依赖
  • 日志级别固定为 ERROR,不能改成 WARNING 或 INFO
  • 若需自定义前缀消息,传入第一个参数,例如:logging.exception("处理用户请求时失败")

自定义格式时慎用 traceback.print_exc()

traceback.print_exc() 默认输出到 sys.stderr,不是返回字符串——这常被误当成“能直接拿到多行文本”的方法。它没有返回值(返回 None),直接 print 会导致无法赋值、拼接或控制输出目标。

GradPen论文
GradPen论文

GradPen是一款AI论文智能助手,深度融合DeepSeek,为您的学术之路保驾护航,祝您写作顺利!

下载

正确做法是:需要字符串就选 format_exc();需要重定向输出(比如写入 StringIO 或网络流)再用 print_exc(file=...)

  • file 参数必须是类文件对象,支持 write() 方法
  • 在 Jupyter 中它会显示在输出区,但返回值仍是 None,不能用于后续处理
  • 性能上,print_exc()format_exc() 开销接近,但前者少了内存拷贝

跨平台换行与编码要注意 \nencoding

生成的多行字符串内部统一用 \n 分隔,不管操作系统。但写入文件或网络时,若目标环境要求 \r\n(如 Windows 记事本),得手动替换或用 open(..., newline='') 控制。

更隐蔽的问题是编码:异常消息可能含非 ASCII 字符(如中文路径、用户输入),format_exc() 返回 str,但写入文件时若没指定 encoding='utf-8',可能触发 UnicodeEncodeError

  • 写文件务必显式声明编码:with open('err.log', 'w', encoding='utf-8') as f: f.write(traceback.format_exc())
  • 不要依赖系统默认编码,尤其在 Docker 容器或 CI 环境中,locale 可能是 C
  • 若需 JSON 序列化该字符串,注意 \n 会被转义,不影响可读性,但体积略增
异常多行字符串的核心就两件事:用对函数(format_exc 而非 str),管住输出端(编码、换行、目标流)。其他包装逻辑都是枝节。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

418

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

535

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

311

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

77

2025.09.10

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

186

2023.09.27

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

295

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

298

2023.08.03

Python 自然语言处理(NLP)基础与实战
Python 自然语言处理(NLP)基础与实战

本专题系统讲解 Python 在自然语言处理(NLP)领域的基础方法与实战应用,涵盖文本预处理(分词、去停用词)、词性标注、命名实体识别、关键词提取、情感分析,以及常用 NLP 库(NLTK、spaCy)的核心用法。通过真实文本案例,帮助学习者掌握 使用 Python 进行文本分析与语言数据处理的完整流程,适用于内容分析、舆情监测与智能文本应用场景。

10

2026.01.27

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.3万人学习

Django 教程
Django 教程

共28课时 | 3.6万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号