需按PHP版本选择Sabre/VObject版本：7.4+用^4.5，7.2–7.3用^3.5；解析前须trim、去BOM、统一对换行；VEVENT必须设UID和UTC格式DTSTAMP；时区处理应使用VObject\DateTime而非原生DateTime。
直接用 composer require 安装，但要注意 PHP 版本和依赖冲突
Sabre/VObject 当前最新稳定版（4.x）要求 PHP >= 7.4；若项目还在用 PHP 7.2 或 7.3，必须锁定旧版本，否则 composer install 会失败或自动降级到不兼容的分支。
执行命令前先确认环境：
php -v
然后按需运行：
- PHP 7.4+：直接
composer require sabre/vobject:^4.5（推荐 4.5.x，修复了多个 iCalendar 时区解析 bug） - PHP 7.2–7.3：只能用
composer require sabre/vobject:^3.5，但注意 v3 不支持VALARM的完整 RFC5545 解析逻辑 - 如果已有
symfony/polyfill-intl-idn或ext-intl缺失，Composer 会报 warning，不是 fatal error，但部分日历中的国际化字段（如中文摘要、带 emoji 的描述）可能被截断或乱码
parse() 解析 .ics 文件时，空行、BOM 和 Windows 换行容易导致 ParseException
真实场景中拿到的 .ics 文件常来自 Outlook、Apple Calendar 或邮件附件，往往带 UTF-8 BOM、\r\n 换行、甚至开头多出空行 —— 这些都会让 VObject\Reader::read() 直接抛 Sabre\VObject\ParseException，而不是静默跳过。
安全做法是预处理字符串：
- 用
file_get_contents()读取后，先 trim：$raw = trim($raw); - 去掉 BOM：
$raw = preg_replace('/^\xEF\xBB\xBF/', '', $raw); - 统一换行符：
$raw = str_replace("\r\n", "\n", $raw); - 再传给
VObject\Reader::read($raw)；别图省事直接读文件句柄，Reader::readFromFile()不做上述清洗
创建新日历时，VEVENT 必须显式设置 UID 和 DTSTAMP，否则 Outlook 拒绝导入
iCalendar 规范要求每个 VEVENT 至少包含 UID、DTSTAMP、DTSTART，但 Sabre/VObject 不强制校验。实际测试发现：Outlook Desktop 和 iOS 日历在缺失 UID 时会静默丢弃整个事件；缺失 DTSTAMP 则显示“未知时间”并标记为损坏。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确写法示例：
$vcal = new VObject\Component\VCalendar();
$event = $vcal->createComponent('VEVENT');
$event->set('UID', uniqid('ev-', true));
$event->set('DTSTAMP', new DateTime('now', new DateTimeZone('UTC')));
$event->set('DTSTART', new DateTime('2024-06-15 14:00:00', new DateTimeZone('Asia/Shanghai')));
$event->set('SUMMARY', '会议：API 设计评审');
$vcal->add($event);
注意：DTSTAMP 必须是 UTC 时间，哪怕 DTSTART 是本地时区 —— 这是 RFC5545 明确规定的，不是兼容性建议。
时区处理最易出错：不要依赖 date_default_timezone_set()，要用 VObject\DateTime 或显式 DateTimeZone
直接 new DateTime('2024-06-15') 会受 PHP 默认时区影响，而 iCalendar 要求所有时间要么带 TZID 参数（如 DTSTART;TZID=Asia/Shanghai:），要么是 UTC（以 Z 结尾）。Sabre/VObject 的 VObject\DateTime 类专为此设计，比原生 DateTime 更可靠。
推荐做法：
- 读取含时区的日历时，用
$event->DTSTART->getDateTime()获取已解析的DateTime对象，它自带时区信息 - 手动构造时，优先用
VObject\DateTime::createFromFormat('Y-m-d H:i:s', '2024-06-15 14:00:00', new DateTimeZone('Asia/Shanghai')) - 避免混用：不要把原生
DateTime直接 set 进组件，否则时区参数可能丢失，导出时变成无 TZID 的本地时间
导出后用 $vcal->serialize() 查看结果，确认关键时间字段是否带 TZID= 或结尾有 Z —— 这是唯一能验证时区是否生效的方式。
