Newest Python PEPs
·
PEP 830：在异常和回溯中添加时间戳
💡
原文英文，约2200词，阅读约需8分钟。
📝
内容提要
PEP 830 提议在 Python 的 BaseException 中添加可选的 __timestamp_ns__ 属性，以记录异常实例化的时间。此功能通过环境变量或命令行标志启用，格式化的回溯将显示时间戳，旨在帮助调试和关联外部日志，尤其是在处理多个异常时。时间戳以纳秒为单位存储，默认情况下禁用，不影响现有异常处理代码。
🎯
关键要点
- PEP 830 提议在 BaseException 中添加可选的 __timestamp_ns__ 属性，以记录异常实例化的时间。
- 该功能通过环境变量或命令行标志启用，格式化的回溯将显示时间戳，旨在帮助调试和关联外部日志。
- 时间戳以纳秒为单位存储，默认情况下禁用，不影响现有异常处理代码。
- 在处理多个异常时，时间戳可以帮助开发者了解异常发生的顺序，尤其是在使用 asyncio.TaskGroup 时。
- 该特性通过 PYTHON_TRACEBACK_TIMESTAMPS 环境变量或 -X traceback_timestamps 命令行选项进行配置。
- 时间戳将以 <@timestamp> 的格式附加到异常消息行中，便于识别。
- 对于高频率的控制流异常（如 StopIteration 和 StopAsyncIteration），不会收集时间戳以避免性能影响。
- 该特性是可选的，不会影响现有的异常处理逻辑，且在禁用时异常的序列化格式保持不变。
❓
延伸问答
PEP 830 的主要内容是什么？
PEP 830 提议在 Python 的 BaseException 中添加可选的 __timestamp_ns__ 属性，以记录异常实例化的时间。
如何启用 PEP 830 中的时间戳功能？
该功能可以通过设置 PYTHON_TRACEBACK_TIMESTAMPS 环境变量或使用 -X traceback_timestamps 命令行选项来启用。
时间戳在异常处理中的作用是什么？
时间戳可以帮助开发者了解异常发生的顺序，尤其是在处理多个异常时，便于调试和关联外部日志。
PEP 830 是否会影响现有的异常处理代码？
不会，PEP 830 默认情况下禁用该特性，不会影响现有的异常处理逻辑。
时间戳的存储格式是什么？
时间戳以纳秒为单位存储，格式为 <@timestamp>，并附加在异常消息行中。
PEP 830 中对控制流异常的处理是怎样的？
对于高频率的控制流异常（如 StopIteration 和 StopAsyncIteration），不会收集时间戳以避免性能影响。
➡️
