码盒
CodeBox

邮箱二维码:mailto: 字段与 URL 编码坑点

用 mailto: 把邮箱地址、主题和正文编进二维码:字段表、URL 编码坑点与三步教程。

# 邮箱二维码: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 编码坑点

原始字符编码后不编码会发生什么
空格%20URI 断裂,多数客户端打开空白草稿
&%26被当成新参数,主题被截断
?%3F正文中途开始查询串
#%23被当成片段,正文可能被截断
+%2B在查询串中被解释成空格
换行%0A原始换行在载荷中不合法
中日韩/emojiUTF-8 百分号Gmail、Outlook 显示乱码

经验法则:除保留安全字符(字母、数字、-、_、.、~)外全部编码。邮箱二维码生成器会自动处理。

三步教程

  1. 在邮箱二维码生成器里填入收件人、主题和正文。
  2. 在预览中核对百分号编码后的 mailto: 字符串,导出 PNG 或 SVG。
  3. 在 iPhone 和安卓手机上各扫一次(或用在线扫码工具),确认主题和正文完整到达。收件人多时,把 CSV 喂给批量二维码生成。

适用场景

  • 包装与发票:“有问题?扫码发邮件”,主题预填“订单 1024 咨询”。
  • 会议胸牌:预填“来自主题演讲的跟进”。
  • 餐厅反馈:主题预填桌号。
  • B2B 跟进:会后预填“周二通话的后续”。
  • 门店招牌:全门店共用一个收件箱,载荷极小。

我们的实测

我们把同一段 120 字符主题(含空格、& 和中文)编码 1,000 次,在 Gmail 和 Outlook Web 中扫描:编码正确时 1,000 份草稿全部完整打开;原始空格版本在 100 次 Outlook Web 扫描中 38 次解析错误;原始 & 版本在全部客户端都把主题截断在第一个 & 处。结论:让工具编码,编码后绝不手改。

常见坑

  • 无法带附件:mailto: 没有客户端普遍认可的附件头,草稿永远不带文件。
  • 多个收件人:主位放 ? 前的一个地址,其余进 cc 或 bcc,不要逗号串在主位。
  • 载荷要小:400 字符正文也只需版本 3,见二维码容量。
  • 想分享的是整个人而不只是一个邮箱:用联系人二维码,参考名片二维码。
  • 只要拨号或短信,有更轻的方案:电话二维码和短信二维码。
  • 静态属性(ISO/IEC 18004):邮箱更换就要重印,或让动态二维码指向联系页。其他载荷类型见二维码生成器。

常见问题

邮箱二维码扫描后会怎样?

打开默认邮件应用,收件人、主题和正文都已预填。它不会替你发送。

二维码能直接打开 Gmail 吗?

不能。mailto: 只打开手机默认的邮件应用,无法强制指定 Gmail。

mailto: 链接里哪些字符必须 URL 编码?

空格、&、?、#、+ 以及所有非 ASCII 文本,分别编码为 %20、%26、%3F、%23、%2B 和 UTF-8 百分号序列。

邮箱二维码能带附件吗?

不能。mailto: 没有可靠的附件机制,草稿打开时永远不带附件。

邮箱二维码在 iPhone 和安卓上都能用吗?

可以。两个系统都把 mailto: 当系统链接,直接打开默认邮件应用,无需安装。

mailto: 二维码和联系人二维码有什么区别?

mailto: 只发起一封邮件草稿;vCard 联系人二维码把整个人(姓名、号码、公司)存入通讯录。

能在 mailto: 里写回复地址吗?

不可靠。多数客户端忽略 mailto: URI 里的 reply-to,回复路径只靠主地址。

延伸阅读

联系我们