python 3.10 logging无新增api但时区支持更成熟；basicconfig在自动化脚本中不安全因仅首次生效；应显式创建命名logger、用rotatingfilehandler分文件、设propagate=false；时间戳改本地时区宜用formatter.converter=time.localtime；须显式close handler防句柄泄漏。
Python 3.10 的 logging 模块本身没有新增 API，但默认启用的 dictConfig 行为、格式化器对时区感知时间的支持，以及与 zoneinfo 的协同更成熟——这意味着你不用改代码也能获得更可靠的时间戳，但若忽略配置细节，日志仍会乱序、丢失或无法按模块隔离。
为什么 root logger 直接用 basicConfig 在自动化脚本里不安全？
自动化脚本常被其他程序导入或作为子进程调用，而 basicConfig 只在 root logger 未配置时生效；一旦上级环境（如 Airflow、Celery 或另一个脚本）已调用过 basicConfig 或 handlers，你的配置就完全失效。
实操建议：
- 永远显式创建并配置
Logger实例，例如logger = logging.getLogger(__name__) - 避免调用
logging.basicConfig()，尤其不要在模块顶层执行 - 若必须快速调试，用
logging.basicConfig(level=logging.DEBUG, force=True)（仅限临时开发，force=True是 Python 3.8+ 才有）
如何让日志按模块名自动分文件且不互相覆盖？
自动化脚本通常由多个模块协作（如 fetcher.py、processor.py），希望各自日志独立写入，又不因并发写入导致内容错乱。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
实操建议：
- 每个模块用
logging.getLogger(__name__)获取唯一命名 logger，避免全用root - 使用
RotatingFileHandler而非FileHandler，防止单个日志文件无限增长：handler = RotatingFileHandler(f"{__name__}.log", maxBytes=5_000_000, backupCount=3) - 设置
propagate=False阻止日志向上冒泡到 root，避免重复输出：logger.propagate = False
Python 3.10 下时间戳带毫秒却显示 UTC，怎么改成本地时区且不崩？
默认 Formatter 使用 time.time()，无时区信息；直接用 datetime.now().strftime() 格式化会导致多线程下时间错乱，而硬塞 zoneinfo.ZoneInfo("Asia/Shanghai") 又可能在旧系统报 ZoneInfoNotFoundError。
实操建议：
- 优先用
logging.Formatter的%(asctime)s+ 自定义converter，而非手动拼字符串：formatter = logging.Formatter("%(asctime)s %(name)s %(levelname)s %(message)s")<br>formatter.converter = time.localtime # 简单有效，兼容所有系统 - 若需明确时区标识（如
+0800），用time.strftime封装：def local_time(*args):<br> return time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())<br>formatter.converter = local_time - 避免在 formatter 中调用
datetime.now().astimezone()—— 它不是线程安全的
最易被忽略的是 handler 的生命周期管理：自动化脚本常以短周期反复运行（如每分钟 cron），若每次新建 FileHandler 却不 close，会导致文件句柄泄漏、日志写入失败，错误信息可能是 OSError: [Errno 24] Too many open files。务必在脚本退出前显式调用 handler.close()，或用上下文管理器封装日志初始化逻辑。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
