推荐优先使用标准库 zoneinfo（Python 3.9+），它轻量、符合 IANA 规范；pytz 适用于旧版本但易出错，需严格遵循 localize + astimezone 范式，二者不可混用。
Python 处理时区，推荐优先用标准库 zoneinfo（Python 3.9+），它无需额外安装、更轻量、更符合 IANA 时区数据库规范；pytz 是旧方案，适用于 Python 3.8 及更早版本，但存在易出错的“本地化”逻辑，新手容易踩坑。
zoneinfo：现代、简洁、推荐首选
zoneinfo 将时区视为不可变对象，通过 ZoneInfo 类直接加载，避免了 pytz 中“先创建 naive 时间再 localize”的繁琐步骤。
- 获取带时区的当前时间：
from zoneinfo import ZoneInfo
from datetime import datetime
beijing = datetime.now(ZoneInfo("Asia/Shanghai"))
new_york = datetime.now(ZoneInfo("America/New_York")) - 转换时区（推荐用
astimezone()）：utc_time = beijing.astimezone(ZoneInfo("UTC")) - 注意：
ZoneInfo不支持字符串缩写（如 "CST"、"PDT"），只认 IANA 标准名称（如 "Asia/Shanghai"、"America/Los_Angeles"）；可用zoneinfo.available_timezones()查看全部支持列表。
pytz：兼容旧版，但需小心 localize 和 astimezone
pytz 的核心陷阱在于：不能直接用 tz.localize(naive_dt) 以外的方式给 naive 时间加时区，也不能对已有时区时间重复调用 localize —— 否则会报错或结果异常。
- 正确方式（先 naive，再 localize）：
import pytz
from datetime import datetime
tz = pytz.timezone("Asia/Shanghai")
naive = datetime(2024, 5, 1, 12, 0)
aware = tz.localize(naive) # ✅ 必须这样 - 跨时区转换必须用
astimezone()，不是tz.normalize()（后者仅用于处理夏令时模糊时间）：utc_aware = aware.astimezone(pytz.UTC) # ✅
- 避免用
datetime(..., tzinfo=pytz.timezone(...))构造，这会跳过 DST 规则校验，导致错误。
常见问题与避坑提醒
-
不要混用 pytz 和 zoneinfo：两者返回的时区对象不兼容，混合使用
astimezone()或比较会引发TypeError。 -
系统时区 ≠ 本地时区：
datetime.now().astimezone()默认用系统时区，但不一定等于你期望的“北京时间”——显式指定ZoneInfo("Asia/Shanghai")更可靠。 -
解析字符串时带时区，优先用
datetime.fromisoformat()（Python 3.7+ 支持带 UTC 偏移的 ISO 字符串）：dt = datetime.fromisoformat("2024-05-01T10:30:00+08:00") # 自动为 aware - 若需支持 Python
try:
（注意：这只是占位，实际逻辑仍需区分处理）
from zoneinfo import ZoneInfo
except ImportError:
from pytz import timezone as ZoneInfo
总结：选哪个？怎么过渡？
新项目统一用 zoneinfo；维护老项目且无法升级 Python 版本时，坚持 pytz 的 localize + astimezone 范式；迁移时重点检查所有 tz.localize() 和 tz.normalize() 调用，替换为 ZoneInfo 实例和 astimezone()。时区本质是地理标识，不是固定偏移，用对工具才能避开夏令时、历史变更等隐藏陷阱。
立即学习“Python免费学习笔记（深入）”；
