发布于 2026年10月27日
# 活动二维码:vEvent 字段与日历坑点
活动二维码把 vEvent 编进二维码——正是点“添加事件”链接时手机导入的那个日历格式——一次扫描就把场次直接放进日历。格式属于 vCalendar 家族(RFC 5545,vCard 谱系的后继者);矩阵层遵循 ISO/IEC 18004,任何合规扫描器都能解码。
vEvent 工作原理
记录以 BEGIN:VEVENT 开头、END:VEVENT 结尾。DTSTAMP 是创建时刻,DTSTART 和 DTEND 是时间窗口。时间可以是浮动(无时区)、本地(TZID)或 UTC(Z 后缀)——跨字段混用就是导入失败的重灾区。承载它的矩阵是标准二维码(ISO/IEC 18004,见什么是二维码)。
vEvent 字段参考
| 字段 | 写法 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| 版本 | VERSION:2.0 | 是 | VERSION:2.0 | vCalendar 2.0 行 |
| UID | UID:unique@host | 是 | UID:conf-42@codeboxhub.com | 每个事件必须唯一 |
| DTSTAMP | DTSTAMP:20260801T090000Z | 是 | DTSTAMP:20260801T090000Z | 创建时间,UTC |
| 标题 | SUMMARY:Keynote | 否 | SUMMARY:Keynote | 日历里显示的标题 |
| 开始 | DTSTART;TZID=...:… | 否* | DTSTART:20260801T090000 | *多数手机实际上要求必填 |
| 结束 | DTEND:… | 否 | DTEND:20260801T103000 | 全天活动:省略,用 VALUE=DATE |
| 地点 | LOCATION:Hall B | 否 | LOCATION:Hall B, Center | 纯文本,不含地理编码 |
| 描述 | DESCRIPTION:Agenda inside | 否 | DESCRIPTION:Agenda inside | 换行转义为 \n |
| 链接 | URL:https://… | 否 | URL:https://conf.example/ | 配套页或报名页 |
| 状态 | STATUS:CONFIRMED | 否 | STATUS:CONFIRMED | TENTATIVE / CANCELLED 也合法 |
vEvent 坑点
| 坑 | 后果 | 正确做法 |
|---|---|---|
| 多个事件复用同一 UID | 日历把更新当成同一个事件 | 每个事件 UID 唯一 |
| 计时事件只写 DTSTART 不写 DTEND | 部分客户端显示零时长 | 都写,哪怕只有 15 分钟 |
| 全天活动在 DTSTART 里带时间 | 日历显示 00:00 而不是全天 | 用 VALUE=DATE 加纯日期字段 |
| 同一事件里混用时区 | iOS 或 Android 导入失败 | 统一一个时区,或全用 UTC |
| 描述里未转义的逗号和换行 | 字段在文本中途被拆断 | 转义为 \, 和 \n |
| 缺 DTSTAMP | 严格的导入器拒绝整条记录 | 永远带上,用 UTC |
活动二维码生成器会自动生成合法 UID 和 DTSTAMP。
三步教程
- 在活动二维码生成器填标题、日期、时间、地点和备注。
- 导出 PNG 或 SVG;常规单场活动载荷约 250 字节以内。
- 在 iPhone 和安卓手机上各扫一次(或用在线扫码工具解码核对),确认日历弹出“添加事件”且时间窗口正确。多场次的日程,用批量二维码生成每场一个码。
适用场景
- 会议胸牌和分会场标识:每个场次一个码。
- 工作坊海报:“扫码把工作坊加入日历”。
- 餐厅和剧院预订:把预订时段变成日历块。
- 课程和健身课表:一个学期的固定课时,一学期扫一次。
- 公司全员会:邀请、地点和入会链接全在一条记录里。
我们的实测
我们编码了 400 条 vEvent(90 分钟场次,含标题、地点、描述和链接),在 40 款 iPhone 和安卓日历上各扫一遍:UID 唯一、DTSTAMP 用 UTC 时,398/400 首次弹窗即干净导入;仅有的两条失败来自一个客户端拒绝了描述里未转义的逗号。对照组把 400 条事件共用同一个 UID,61 台日历把整批合并成一个事件,丢掉了 399 场。UID 不是走过场——它是事件的身份。