FileHandler 初始化时 mode 应选 'a'（追加），除非明确需每次清空日志；encoding 必须设为 'utf-8' 防止中文乱码；delay=True 可延迟文件打开，提升初始化健壮性；关键日志后需手动 flush 保证写入磁盘。
FileHandler 初始化时 mode 参数选 'a' 还是 'w'？
默认用 'a'（追加），除非你明确需要每次启动都清空旧日志。用 'w' 会导致历史日志被覆盖，调试时容易丢失线索；但某些临时脚本或单次批处理任务中，'w' 可避免日志文件无限增长。
常见错误现象：程序重启后发现日志“不见了”——大概率是误设了 mode='w'，且没注意日志文件被重写。
- 开发/调试阶段一律用
mode='a' -
mode='w'仅适用于已知日志只需当前会话、且无回溯需求的场景 - 若需轮转（如按天切分），不要用
FileHandler，改用TimedRotatingFileHandler或RotatingFileHandler
encoding 参数不设 utf-8 会出什么问题？
Windows 系统下默认编码常为 cp1252 或 gbk，遇到中文、emoji 或特殊符号时会抛出 UnicodeEncodeError，典型错误信息是：UnicodeEncodeError: 'charmap' codec can't encode character '\u2705' in position 10: character maps to <undefined></undefined>。
解决方法很简单：显式指定 encoding='utf-8'。Python 3.9+ 虽在部分场景自动 fallback，但不保证跨平台一致。
- 只要日志内容可能含非 ASCII 字符（包括中文、日文、路径名、用户输入），就必须设
encoding='utf-8' - 不要依赖系统默认值，尤其当脚本要部署到不同环境（Windows/macOS/Linux）时
- 如果已出现乱码文件，用文本编辑器以 UTF-8 无 BOM 模式重新打开并另存，不能直接改后缀
delay=True 能解决什么实际问题？
delay=False（默认）会在创建 FileHandler 实例时立刻尝试打开文件——这意味着即使你还没调用 logger.info()，只要 FileHandler("logs/app.log") 执行，就会检查路径是否可写、父目录是否存在。一旦路径非法（比如 logs/ 目录不存在），立即报 FileNotFoundError。
设 delay=True 可把文件创建延迟到第一次真正写日志时，配合 os.makedirs(os.path.dirname(filename), exist_ok=True) 更安全。
- 推荐组合：
delay=True+ 提前确保目录存在（或捕获首次写入时的异常） - 不建议只靠
delay=True来“掩盖”路径问题，它只是推迟报错，不是修复 - 在容器或无权写根目录的环境中，
delay=True能让初始化更健壮，但最终仍需处理权限失败
为什么日志写进去了却看不到最新内容？
不是磁盘没写，而是 Python 的 I/O 缓冲机制导致：日志消息进了内核缓冲区，但还没刷到磁盘文件。典型表现是程序正常退出后能看见完整日志，但强制终止（Ctrl+C、kill -9）或崩溃时末尾几条消失。
FileHandler 本身不提供自动 flush 控制，必须靠 logging.basicConfig(..., force=True) 或手动触发，但更稳妥的做法是用 handlers=[...] 显式构造，并在关键节点调用 handler.flush()。
- 对可靠性要求高的场景（如金融、状态变更），应在关键日志后加
logger.handlers[0].flush() - 避免在循环里频繁 flush，会显著拖慢性能
- 若用
basicConfig，无法单独控制某个 handler 的 flush 行为，建议放弃它，改用显式Logger+FileHandler构造
