Python datetime时区与精度问题需统一使用aware时间、perf_counter测耗时、禁用非标准strftime格式符、Python 3.9+只用zoneinfo；混用naive/aware、time.time()/perf_counter()、pytz/zoneinfo或跨平台格式符将导致TypeError、时间错乱或不可复现故障。
datetime 时区偏移不一致导致时间错乱
Python 的 datetime 对象分“有意识”和“无意识”两种：带 tzinfo 的是 aware，没带的是 naive。混用它们做加减、比较或序列化（比如存进数据库、转成 timestamp），大概率触发 TypeError: can't compare offset-naive and offset-aware datetimes 或静默得出错误结果。
实操建议：
立即学习“Python免费学习笔记（深入）”；
Python 编程规范与最佳实践。强制 PEP 8 代码风格、语法校验、单元测试执行，适用于代码编写、审查和重构。触发词：Python、代码规范、py_compile、单元测试。
- 统一使用
datetime.now(tz=zone)或datetime.utcnow().replace(tzinfo=timezone.utc)创建 aware 时间，别依赖datetime.now()默认返回 naive 值 - 从字符串解析时，优先用
dateutil.parser.parse()并传ignoretz=False；若用strptime，务必手动补tzinfo，例如dt.replace(tzinfo=ZoneInfo("Asia/Shanghai")) - 写入数据库前检查类型：
if dt.tzinfo is None就别硬塞——很多 ORM（如 SQLAlchemy）对 naive 时间按本地时区解释，但本地时区可能不是你预期的那个
time.time() 和 time.perf_counter() 混用引发性能误判
想测函数耗时，却用了 time.time()，结果在跨天、NTP 校时或系统休眠后拿到负值或跳变值；反过来，用 time.perf_counter() 去算“绝对时间点”，又发现它不能转成可读时间或参与日志时间戳。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 测执行耗时 → 无条件用
perf_counter()：它不随系统时间调整，精度高，专为性能测量设计 - 记录事件发生时刻 → 用
time.time()（秒级浮点）或datetime.now(timezone.utc)（结构化、带时区） - 避免把
perf_counter()的返回值存进日志或数据库——它只是单调递增数，没有语义，重启后重置
strftime 格式符在 Windows 和 Linux 下行为不一致
strftime 里像 %-d（Linux 去零）、%#d（Windows 去零）这种非标准格式符，一换环境就报 ValueError: Invalid format string；更隐蔽的是 %Y 和 %y 在处理 2000 年前日期时，某些 C 库实现会崩。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 跨平台项目禁用所有带修饰符的格式符（
%-d、%#m等），改用字符串切片或str(d.day)拼接 - 年份一律用
%Y，不用%y——后者只取两位，2025 年变成25，再转回来容易歧义 - 如果必须用 locale 相关格式（如中文月份），先确认
locale.setlocale(locale.LC_TIME, ...)是否生效，且目标机器装了对应 locale 包（Linux 上常缺zh_CN.UTF-8）
pytz 与 zoneinfo 混用触发不可靠时区转换
老代码用 pytz.timezone("Asia/Shanghai")，新代码用 ZoneInfo("Asia/Shanghai")，两者返回的对象不能直接传给同一个 astimezone() 调用；更麻烦的是 pytz 的 localize() 和 astimezone() 行为跟 zoneinfo 完全不同，强行混用会导致夏令时计算错误或 NonExistentTimeError。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- Python 3.9+ 新项目只用
zoneinfo：导入from zoneinfo import ZoneInfo，构造时区对象直接ZoneInfo("Asia/Shanghai") - 升级旧项目时，别留
pytz的localize()调用——它会把 naive 时间强行绑上固定偏移，忽略后续夏令时变化；应改用dt.replace(tzinfo=ZoneInfo(...))或dt.astimezone(ZoneInfo(...)) - 注意
ZoneInfo不支持缩写时区名（如"CST"），必须用 IANA 名称（"America/Chicago"），否则抛ZoneInfoNotFoundError
