icalendar解析ICS中文乱码需调用event.decoded('summary')或email.header.decode_header()；Google与iCloud无法直连，iCloud须用CalDAV+App Password；同步须以UID为锚点并维护ID映射表；OAuth凭据过期应捕获RefreshError并提示重授权。
用 icalendar 解析本地 ICS 文件时，中文标题乱码怎么办
常见现象是读出的 summary 字段变成 b'=?UTF-8?B?...' 或直接显示为乱码字符串。这不是编码错误，而是 RFC 5575 定义的 MIME encoded-word 格式，icalendar 默认不自动解码。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 手动调用
email.header.decode_header()处理event.get('summary')的原始字节值 - 或改用
icalendar.cal.Calendar.from_ical()后，对每个event调用event.decoded('summary')—— 这个方法会自动处理编码和换行 - 注意：若 ICS 文件本身未声明
CHARSET=utf-8，部分老导出工具（如 Outlook）可能默认用 GBK 写入，此时需先用chardet检测并重读文件
Google Calendar API 和 Apple iCloud 日历之间能直连同步吗
不能。Apple 没有开放标准的、可编程访问 iCloud 日历的公开 API；其日历数据仅能通过 WebDAV（https://pXX-caldav.icloud.com）协议读写，且需配合双重认证 App Password，无法使用常规 OAuth2。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- Google Calendar 使用官方
google-api-python-client+ OAuth2 流程，支持增删改查，稳定可靠 - iCloud 日历必须走 CalDAV：用
caldav库连接，用户名是 Apple ID，密码必须是「应用专用密码」（非账户密码），且需在 Apple ID 设置中开启双重认证后生成 - WebDAV 地址中的
pXX是动态分配的，需从 iCloud 网页版「设置 → 高级 → 更多日历设置」里复制真实 URL，不能硬编码
caldav 库同步事件时，怎么避免重复创建或误删已有日程
CalDAV 协议本身不提供全局唯一 ID（UID）的强制校验机制，不同客户端生成的 UID 格式不一，且部分平台（如某些 Outlook 导出）甚至缺失 UID 字段。直接按时间范围拉取再全量覆盖，极易出错。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 始终以
event.uid为同步锚点：两边都优先用它匹配，而非开始时间+标题组合 - 本地维护一个轻量映射表（如 JSON 文件），记录
{google_event_id: icloud_object_id}，用于跨平台 ID 转换（Google 返回的是长哈希串，iCloud 返回的是类似1234567890.ics的路径片段） - 删除操作必须加确认条件：只删「远程存在、本地已标记为删除、且最后修改时间早于本地记录」的事件；切勿用
calendar.date_search()后直接调用event.delete()
定时运行同步脚本时，OAuth2 凭据过期或刷新失败怎么处理
Google 的 refresh_token 理论上长期有效，但实际中可能因用户主动撤回权限、账号异常或超过 6 个月未使用而失效，此时 credentials.refresh() 会抛出 RefreshError。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 捕获
google.auth.exceptions.RefreshError，并在日志中明确输出"OAuth token expired, need re-auth"，同时退出进程（不要静默重试） - 把
token.json存放在非临时目录（如~/.config/calendar-sync/token.json），避免容器重启或 cron 用户环境丢失文件 - 首次授权必须交互式完成：脚本检测到无
token.json时，应打印完整授权 URL 并阻塞等待用户粘贴回调码，而不是依赖 headless 浏览器自动化 —— Google 明确禁止后者
真正难的不是写通两个 API，而是处理 UID 不一致、时区字段缺失、重复提醒规则冲突这些隐性差异。每次同步前，建议先用 event.to_ical().decode() 打印原始字段对比，比肉眼检查界面快得多。
