Python配置日志格式教程_统一日志规范_网络技术

Python配置日志格式教程_统一日志规范

发布时间 - 2026-01-11 00:00:00 点击率：次

Python日志配置核心是通过basicConfig或Formatter+Handler统一格式，推荐含时间、级别、模块名、行号和消息的结构化输出，兼顾可读性与机器解析；需注意调用时机、第三方库适配及生产环境输出目标选择。

Python中配置日志格式，核心是通过logging.basicConfig()或Formatter对象定义输出样式，让所有日志具备时间、级别、模块名、行号和消息等统一字段，便于排查问题和集中采集。

用basicConfig快速统一基础格式

适合脚本或简单项目，一行代码即可生效（注意：仅首次调用有效）：

import logging logging.basicConfig( level=logging.INFO, format='%(asctime)s [%(levelname)-5s] %(name)s:%(lineno)d - %(message)s', datefmt='%Y-%m-%d %H:%M:%S' )

说明：

%(asctime)s：自动注入格式化后的时间，依赖datefmt
[%(levelname)-5s]：左对齐、占5字符宽的级别名（如 INFO、ERROR）
%(name)s：记录器名（默认为root，可自定义）
%(lineno)d：日志所在源码行号，调试时非常关键
该配置会影响所有未单独设置handler的logger

用Formatter+Handler精细控制多输出目标

当需同时输出到控制台和文件，并且格式/级别不同，推荐显式创建Handler：

import logging
logger = logging.getLogger('myapp')
logger.setLevel(logging.DEBUG)
控制台输出（简洁格式）
console_handler = logging.StreamHandler()
console_formatter = logging.Formatter(
'%(levelname)s - %(message)s'
)
console_handler.setFormatter(console_formatter)
logger.addHandler(console_handler)
文件输出（完整格式，含时间与位置）
file_handler = logging.FileHandler('app.log', encoding='utf-8')
file_formatter = logging.Formatter(
'%(asctime)s | %(levelname)-8s | %(name)s:%(funcName)s:%(lineno)d | %(message)s',
datefmt='%Y-%m-%d %H:%M:%S'
)
file_handler.setFormatter(file_formatter)
logger.addHandler(file_handler)

关键点：

每个Handler可绑定独立Formatter，实现“同日志、不同展现”
%(funcName)s能显示函数名，比%(name)s更准确定位逻辑位置
文件Handler建议加encoding='utf-8'避免中文乱码
务必调用logger.addHandler()，否则日志不会输出到该目标

统一规范建议（团队协作推荐）

为保障日志可读性与机器可解析性，建议固定以下字段顺序和格式：

时间戳：%(asctime)s + datefmt='%Y-%m-%dT%H:%M:%S'（ISO 8601，利于ELK解析）
日志级别：[%(levelname)-5s]，大写、左对齐、固定宽度
模块标识：%(name)s（按模块命名logger，如logging.getLogger(__name__)）
代码位置：%(filename)s:%(lineno)d 或 %(module)s.%(funcName)s:%(lineno)d
业务消息：%(message)s，避免换行，关键参数用logger.info("user_id=%s, action=%s", uid, action)结构化传入

避免常见坑

实际配置中容易忽略的细节：

basicConfig()必须在任何logger.xxx()之前调用，否则无效
若使用第三方库（如requests、sqlalchemy），它们自带logger，需单独设置其level（如logging.getLogger("requests").setLevel(logging.WARNING)）
生产环境禁用StreamHandler，优先写文件或对接Syslog/Fluentd
不要在format字符串里硬编码颜色或ANSI序列——终端渲染应由Handler（如colorlog）负责，而非Formatter

# python # 编码 # app # 中文乱码 # stream # asic

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：VSCode多光标编辑功能详解

下一篇：composer fund命令是干什么用的_讲解compos

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：VSCode多光标编辑功能详解

下一篇：composer fund命令是干什么用的_讲解compos