python 的 dateutil.rrule 不支持节假日感知，仅适用于规则周期场景；应预加载节假日 set 过滤 rrule 结果，或用 workalendar 并显式指定年份校验数据完整性，避免依赖实时 api 或手写逻辑出错。
Python 用 dateutil.rrule 做工作日偏移容易漏掉节假日
直接用 rrule 的 BYDAY 或 count 参数只能过滤周末，完全不感知法定节假日。比如调休上班日会被当成休息日跳过，而真正的假期（如国庆7天）里又可能混着工作日——rrule 没法动态识别。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 别单独依赖
rrule做业务时间推算，它只适合规则周期场景（如“每周三上午”），不是节假日感知型工具 - 先用
dateutil.rrule.rrule生成候选日期，再用节假日列表逐个过滤，但注意性能：1年要查365次，别在循环里重复读文件或发HTTP请求 - 推荐把节假日数据预加载成
set，比如holidays = {date(2024,1,28), date(2024,2,10), ...}，in查找是 O(1)
用 workalendar 库时要注意中国农历节日和调休逻辑
workalendar 提供了 China 日历类，但它默认只覆盖国务院发布的放假安排（需每年手动更新），且对调休日的判断依赖内置规则——比如它认为“周六补班”是工作日，但如果你的业务系统没同步当年调休表，结果就错。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 初始化时显式指定年份：
cal = China(years=[2024])，否则默认只加载当前年，跨年计算会漏判 - 调用
cal.is_working_day(date_obj)前，确认该版本库已包含你所需年份的调休数据（查 GitHub release 或运行cal.holidays(2024)看返回长度是否为 11） - 不要信任
cal.add_working_days()的链式调用结果——它内部用的是简单 while 循环+逐日试探，遇到长假（如中秋+国庆连休）可能多跳1–2天，务必用已知日期对结果做断言校验
datetime + 手写节假日判断函数的边界情况
自己维护一个节假日列表看似可控，但容易在三个地方出错：节气日（如冬至不算假）、纪念日（如抗战胜利日不放假）、以及最麻烦的「调休补班日」——它既不是周末也不是法定假日，却是实际工作日。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 国务院每年12月发布下一年放假安排，PDF 表格里「调休上班」那几行必须人工转成
date对象加入working_days_override集合 - 避免用字符串匹配判断节日，比如
"国庆"可能出现在备注里，应严格比对日期值 - 如果业务允许容忍1天误差，可把所有法定假日前后各延1天设为「缓冲区」，统一按休息日处理；否则必须精确到每个
date实例
生产环境别用 requests 实时查节假日API
网上有些教程教用 HTTP 请求调第三方节假日 API（如 https://api.apihug.com/holiday/v1/...），线上跑着跑着就超时或限流，而且响应格式随时可能变，错误码也未必有文档。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 任何外部 HTTP 调用都必须加 fallback：本地缓存 JSON 文件 + 更新时间戳，API 失败时自动降级读缓存
- 缓存文件路径建议硬编码，比如
./data/holidays_2024.json，别拼接变量，防止路径穿越或空值报错 - CI 流程中加入检查：每次部署前验证该 JSON 是否存在、能否
json.load()、是否包含至少10个date字段——少于这个数大概率是下载失败或格式损坏
