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'
)</font><p>说明：</p><ul><li><code>%(asctime)s</code>：自动注入格式化后的时间，依赖<code>datefmt</code></li><li><code>[%(levelname)-5s]</code>：左对齐、占5字符宽的级别名（如 INFO、ERROR）</li><li><code>%(name)s</code>：记录器名（默认为<code>root</code>，可自定义）</li><li><code>%(lineno)d</code>：日志所在源码行号，调试时非常关键</li><li>该配置会影响所有未单独设置handler的logger</li></ul><H3>用Formatter+Handler精细控制多输出目标</H3><p>当需同时输出到控制台和文件，并且格式/级别不同，推荐显式创建Handler：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill5772" title="Python Use Agent"><img
src="https://img.php.cn/upload/skill/000/000/081/179065807481489.jpg" alt="Python Use Agent" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill5772" title="Python Use Agent">Python Use Agent</a>
<p>智能执行Python任务，自动生成、执行代码并反馈结果，无需额外配置，兼容旧命令。</p>
</div>
<a href="/xiazai/skill5772" title="Python Use Agent" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><font color="gray"><pre class="brush:php;toolbar:false;">import logging
<p>logger = logging.getLogger('myapp')
logger.setLevel(logging.DEBUG)</p><h1>控制台输出（简洁格式）</h1><p>console_handler = logging.StreamHandler()
console_formatter = logging.Formatter(
'%(levelname)s - %(message)s'
)
console_handler.setFormatter(console_formatter)
logger.addHandler(console_handler)</p><h1>文件输出（完整格式，含时间与位置）</h1><p>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
