如何利用Python的logging模块配置既输出控制台又写入文件的日志？-Python教程-PHP中文网

可以同时添加 streamhandler 和 filehandler 到同一个 logger，因为每个 handler 是独立输出通道：streamhandler 输出到终端，filehandler 写入文件；logger 仅负责收集分发，不决定输出目标，缺一不可。

如何利用python的logging模块配置既输出控制台又写入文件的日志？

可以同时添加 StreamHandler 和 FileHandler 到同一个 logger，但必须注意 handler 的 level、formatter 和日志传播关系，否则容易出现重复输出或某端无日志。

为什么只加一个 handler 不行？

每个 Handler 是独立的日志输出通道：StreamHandler 负责打印到终端，FileHandler 负责写入文件。logger 本身不决定“往哪写”，只负责收集和分发日志记录——真正输出靠绑定的 handler。漏掉任一 handler，对应目标就收不到日志。

常见错误现象：logger.info("test") 只在控制台显示、文件为空；或反过来；甚至同一行日志打印两遍（比如 logger 和 root logger 同时生效）。

关键点：

确保 logger 的 propagate=False，避免日志向上冒泡到 root logger 导致重复
两个 handler 的 level 至少要 ≤ logger 的 level，否则会被过滤掉
务必为每个 handler 单独设置 setFormatter()，共用 formatter 没问题，但漏设会导致输出格式混乱（如文件里没时间、控制台里多出空行）

最简可用配置示例

以下代码创建一个名为 "myapp" 的 logger，同时输出到终端和 app.log：

python-parallelization

将顺序 Python 代码转换为并行/并发实现，用于在需要并行化 Python 代码、提升性能时使用。

下载

import logging
<p>logger = logging.getLogger("myapp")
logger.setLevel(logging.DEBUG)  # logger 级别决定哪些日志能进来
logger.propagate = False      # 关键！防止发给 root logger</p><h1>控制台输出</h1><p>console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)  # 只让 INFO 及以上到终端
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_handler.setLevel(logging.DEBUG)  # 文件记录更详细
file_formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
file_handler.setFormatter(file_formatter)
logger.addHandler(file_handler)</p><h1>测试</h1><p>logger.debug("调试信息")   # 只进文件
logger.info("普通信息")    # 进文件 + 终端
</p>

容易踩的坑：编码、路径、多进程写入

FileHandler 默认用系统 locale 编码，在 Windows 中可能报 UnicodeEncodeError。务必显式传 encoding="utf-8"。

相对路径如 "logs/app.log" 依赖当前工作目录（os.getcwd()），不是脚本所在目录。建议用 pathlib.Path(__file__).parent / "logs" / "app.log" 构造绝对路径。

多个进程同时写同一个日志文件会损坏内容。生产环境应改用 RotatingFileHandler 或 TimedRotatingFileHandler，并配合 delay=True 避免启动时立即创建文件；若真需多进程安全，得上 concurrent-log-handler 这类第三方包。

还有个隐蔽问题：如果后续代码调用了 logging.basicConfig()，它会自动给 root logger 加 handler，而你的 logger 若 propagate=True（默认值），就会被二次处理——所以 propagate=False 不是可选项，是必选项。

实际项目里，handler 的 level 往往比 logger 更细：比如 logger 设 DEBUG，控制台只 show WARNING+，文件保留全部。这种分级控制才是 logging 模块的核心价值，而不是堆砌一堆 print。