Python logging模块无需额外安装即可实现分级记录、多目标输出、格式自定义和自动轮转；关键在于规避日志不显示、文件未生成、级别被忽略、多进程错乱等常见问题。
Python 自带的 logging 模块足够强大，不用额外装包就能实现分级记录、多输出目标、格式自定义和自动轮转。关键不是“能不能用”，而是“怎么避免踩坑”——比如日志不显示、文件没生成、级别被忽略、多进程写入错乱等。
基础配置：别直接用 print，从 logging.basicConfig 开始
刚上手时，最简单可靠的方式是调用 logging.basicConfig() 一次性设定全局行为。它只生效一次，必须在导入其他模块前（或至少在首次调用 logging.debug() 前）执行。
- 设置日志级别：
level=logging.INFO表示 INFO 及以上（INFO、WARNING、ERROR、CRITICAL）才会输出，DEBUG 被静默 - 指定输出位置：
filename='app.log'写入文件；不加该参数则默认输出到控制台 - 统一格式：
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'，其中%(name)s默认是root，后续可换为自定义名称
示例：
import logginglogging.basicConfig(
level=logging.INFO,
filename='run.log',
format='%(asctime)s - %(levelname)s - %(message)s',
datefmt='%Y-%m-%d %H:%M:%S'
)
logging.info("服务已启动")
进阶结构：用 getLogger + Handler 实现灵活分流
当项目变大，你需要把不同模块的日志分开存（如 web 请求进 access.log，数据库错误进 db.log），或同时输出到文件和控制台——这时就不能只靠 basicConfig，得手动构造 logger 和 handler。
立即学习“Python免费学习笔记（深入）”；
- 获取独立 logger：
logger = logging.getLogger('api')，名字相同就拿到同一个实例，推荐用模块名（如__name__）保证层级清晰 - 添加多个 handler：一个
FileHandler写文件，一个StreamHandler打印到终端，各自可设不同级别和格式 - 注意传播（propagate）：默认为 True，意味着子 logger 的日志会向上冒泡到 root；若不希望重复打印，设
logger.propagate = False
常见组合：
logger = logging.getLogger('db')logger.setLevel(logging.DEBUG)
# 文件 handler（只存 ERROR）
fh = logging.FileHandler('db_error.log')
fh.setLevel(logging.ERROR)
fh.setFormatter(logging.Formatter('%(levelname)s:%(message)s'))
# 控制台 handler（显示 DEBUG 起）
sh = logging.StreamHandler()
sh.setLevel(logging.DEBUG)
sh.setFormatter(logging.Formatter('%(name)s - %(message)s'))
logger.addHandler(fh)
logger.addHandler(sh)
安全轮转：按大小或时间自动切分日志文件
生产环境不能让一个 log 文件无限增长。logging 提供两个内置轮转 handler：
-
RotatingFileHandler：按文件大小切分，例如单个最大 5MB，最多保留 5 个旧文件 -
TimedRotatingFileHandler：按时间切分，如每天生成一个新文件（when='midnight'），或每小时（when='h'）
关键参数：
# 每个文件不超过 2MB，最多保留 3 个历史文件handler = RotatingFileHandler(
'app.log',
maxBytes=2*1024*1024,
backupCount=3
)
# 每天零点切分，保留 7 天日志
handler = TimedRotatingFileHandler(
'access.log',
when='midnight',
interval=1,
backupCount=7,
encoding='utf-8'
)
避坑要点：几个高频问题与解法
很多日志“不工作”，其实只是配置顺序或层级错了：
- 日志没输出？检查是否调用了
basicConfig()或设置了 logger 级别，且 handler 级别不低于 logger 级别（双重要求） - 中文乱码？Windows 控制台默认 GBK，建议在
FileHandler中显式加encoding='utf-8' - 多进程写同一个文件冲突？
RotatingFileHandler不是进程安全的，生产中建议用ConcurrentLogHandler（需 pip 安装）或改用日志服务（如 syslog、ELK） - 想在异常时自动打印 traceback？用
logger.exception('出错了')，它等价于logger.error('出错了', exc_info=True)
