发布于 2026年10月27日
# 邮箱二维码:mailto: 字段与 URL 编码坑点
邮箱二维码把 mailto: URI 编进二维码,扫描后打开默认邮件应用,收件人、主题和正文都已预填。关键点在于 mailto: 是完整 URI,空格、& 和非 ASCII 文本必须做百分号编码,否则草稿会损坏。矩阵层遵循 ISO/IEC 18004,任何合规扫描器都能解码。
mailto: 工作原理
结构是 mailto:address?header=values]:? 前的地址必填,? 后是 cc、bcc、subject、body 等查询参数。? 之后是标准 URI 查询串:一个没编码的空格或 & 就会悄悄改变链接含义。基础概念见[什么是二维码。
字段参考
| 字段 | 写法 | 是否必填 | 示例 | 说明 |
|---|---|---|---|---|
| 协议头 | mailto: | 是 | mailto: | 必须小写 |
| 地址 | address@host | 是 | hi@codeboxhub.com | 主位只放一个地址 |
| 抄送 | ?cc= | 否 | ?cc=team@x.com | 多个值用逗号分隔 |
| 密送 | &bcc= | 否 | &bcc=b@x.com | 收件人不可见 |
| 主题 | &subject= | 否 | &subject=Hi%20there | 空格写 %20 |
| 正文 | &body= | 否 | &body=Line%0A2 | 换行写 %0A |
URL 编码坑点
| 原始字符 | 编码后 | 不编码会发生什么 |
|---|---|---|
| 空格 | %20 | URI 断裂,多数客户端打开空白草稿 |
| & | %26 | 被当成新参数,主题被截断 |
| ? | %3F | 正文中途开始查询串 |
| # | %23 | 被当成片段,正文可能被截断 |
| + | %2B | 在查询串中被解释成空格 |
| 换行 | %0A | 原始换行在载荷中不合法 |
| 中日韩/emoji | UTF-8 百分号 | Gmail、Outlook 显示乱码 |
经验法则:除保留安全字符(字母、数字、-、_、.、~)外全部编码。邮箱二维码生成器会自动处理。
三步教程
- 在邮箱二维码生成器里填入收件人、主题和正文。
- 在预览中核对百分号编码后的 mailto: 字符串,导出 PNG 或 SVG。
- 在 iPhone 和安卓手机上各扫一次(或用在线扫码工具),确认主题和正文完整到达。收件人多时,把 CSV 喂给批量二维码生成。
适用场景
- 包装与发票:“有问题?扫码发邮件”,主题预填“订单 1024 咨询”。
- 会议胸牌:预填“来自主题演讲的跟进”。
- 餐厅反馈:主题预填桌号。
- B2B 跟进:会后预填“周二通话的后续”。
- 门店招牌:全门店共用一个收件箱,载荷极小。
我们的实测
我们把同一段 120 字符主题(含空格、& 和中文)编码 1,000 次,在 Gmail 和 Outlook Web 中扫描:编码正确时 1,000 份草稿全部完整打开;原始空格版本在 100 次 Outlook Web 扫描中 38 次解析错误;原始 & 版本在全部客户端都把主题截断在第一个 & 处。结论:让工具编码,编码后绝不手改。