系统时区为PDT/PST时Python识别为UTC的原因及解决方法

问题背景 #

Ubuntu 22.04.1 LTS系统中，时区已正确设置为America/Vancouver，系统层面验证完全符合预期：

$ file /etc/localtime 
/etc/localtime: symbolic link to /usr/share/zoneinfo/America/Vancouver

$ date
Thu 17 Nov 10:31:38 PST 2022

$ date '+%Y-%m-%d %H:%M:%S%z'
2022-11-17 10:32:57-0800

$ date '+%Y-%m-%d %H:%M:%S%Z'
2022-11-17 10:33:04PST

但Python 3.10.8却显示时区为UTC，与系统时区不符：

$ python -c "import time; print(time.tzname); print(time.localtime());"
('UTC', 'UTC')
time.struct_time(tm_year=2022, tm_mon=11, tm_mday=17, tm_hour=18, tm_min=34, tm_sec=0, tm_wday=3, tm_yday=321, tm_isdst=0)

$ python -c 'from datetime import datetime; print(datetime.utcnow()); print(datetime.now());'
2022-11-17 18:34:38.878930
2022-11-17 18:34:38.878956

需求：无需硬编码时区，让Python自动匹配系统本地时区，解决time.tzname显示错误的问题。

问题原因 #

1. TZ环境变量覆盖：Python的time模块和无参数datetime.now()优先读取TZ环境变量，如果该变量被设置为UTC，会直接覆盖系统时区配置。
2. 环境变量未继承：如果Python在非交互式shell（如服务、cron任务）中运行，可能没有继承正确的系统环境变量，导致时区读取异常。
3. 时区数据缺失：自定义Python环境（如pyenv）可能未安装tzdata包，无法正确解析系统时区文件。

解决方法 #

1. 检查并配置TZ环境变量 #

先验证当前shell的TZ变量：

echo $TZ

若输出为空或UTC，手动设置为系统时区：

export TZ='America/Vancouver'

测试Python命令，此时time.tzname应正确显示('PST', 'PDT')。

如需永久生效，将上述export命令添加到~/.bashrc（交互式shell）或服务启动脚本中（后台进程）。

2. 修复系统时区配置 #

确保系统时区数据库完整，重新生成时区配置：

sudo apt install tzdata
sudo ln -sf /usr/share/zoneinfo/America/Vancouver /etc/localtime
sudo dpkg-reconfigure -f noninteractive tzdata

3. 使用时区感知的datetime方法（推荐） #

Python 3.9+自带zoneinfo模块，可直接读取系统本地时区，无需依赖环境变量：

from datetime import datetime
from zoneinfo import ZoneInfo

local_tz = ZoneInfo('local')
now = datetime.now(local_tz)
print(now)          # 输出带时区的本地时间
print(now.tzname()) # 输出PST/PDT

4. 补全自定义Python环境的时区数据 #

如果使用pyenv等独立Python环境，安装tzdata包：

pip install tzdata

内容的提问来源于stack exchange，提问作者Duncan Lock