Python日志记录超简单入门：5分钟搞定logging基础

原创于 2025-11-30 10:02:42 发布 · 779 阅读

CC 4.0 BY-SA版权

输入框内输入如下内容：

创建一个最简单的Python logging示例，包含：1. 基础控制台日志输出 2. 区分INFO和ERROR级别 3. 带时间戳的日志格式 4. 一个简单的异常捕获示例。代码不超过50行，每行都有中文注释说明，使用最简单的配置方式。

示例图片

最近在学Python时发现，很多教程都会提到日志记录（logging）这个功能，但作为新手总觉得配置起来很复杂。实际体验后发现，用Python自带的logging模块实现基础功能其实特别简单！今天就用最直白的方式，带大家快速掌握logging的核心用法。

刚开始写代码时，我习惯用print直接输出调试信息。但随着项目变大，这种方式会带来几个问题：

而logging模块正好能解决这些问题，而且配置起来比想象中简单很多。

先来看最基本的用法——在控制台输出日志。只需要三行代码：

这里设置了INFO级别（表示常规信息），所以DEBUG级别的日志不会显示。如果想看所有日志，把级别改成DEBUG即可。

logging提供了5个常用级别，按重要性从低到高：

实际使用时，可以根据情况选择输出级别。比如日常运行只关注INFO及以上，排查问题时可以临时开启DEBUG。

让日志包含时间信息特别实用。在basicConfig中指定format参数即可：

这个格式字符串中： - %(asctime)s 会自动替换为当前时间 - %(levelname)s 显示日志级别 - %(message)s 是输出的日志内容

时间格式也可以自定义，比如加上毫秒或调整日期顺序。

记录异常信息是logging最常用的场景之一。配合try-except使用：

相比单纯打印错误，这种方式能保留更多调试信息。

刚开始用logging时遇到过几个常见问题：

建议一开始就养成规范使用的习惯。

掌握基础用法后，还可以尝试：

这些高级功能在logging模块中都有现成方案。

在实际开发中，我习惯先用basicConfig快速搭建日志框架，等需要更多功能时再逐步扩展。对于刚接触Python的同学，推荐从这篇介绍的基础用法开始尝试。

最近发现InsCode(快马)平台特别适合练习这类小功能，不用配置环境就能直接运行代码，还能一键保存和分享。他们的在线编辑器响应速度很快，对于想快速验证想法的场景特别方便。

示例图片

如果想把日志功能集成到Web项目中，平台的部署功能也很省心。上次我写了个带日志监控的小工具，点几下就上线了：

示例图片

建议新手朋友可以先用这个例子练手，遇到问题欢迎交流讨论~

输入框内输入如下内容：

创建一个最简单的Python logging示例，包含：1. 基础控制台日志输出 2. 区分INFO和ERROR级别 3. 带时间戳的日志格式 4. 一个简单的异常捕获示例。代码不超过50行，每行都有中文注释说明，使用最简单的配置方式。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考