内嵌图片需用 symfony mime 的 embedfrompath() 或 datapart::frompath()->asinline()，并严格通过 cid: 前缀引用自动生成的 content-id；html 中 src 必须为 cid: 格式，且 mime 类型需准确指定以防客户端拒绝渲染。
内嵌图片不是简单地把 <img src="xxx.jpg"> 写进 HTML 就能发出去的——邮件客户端会拒绝加载本地路径，也不认相对 URL。Symfony MIME 的 embedFromPath() 或 DataPart::fromPath()->asInline() 才是正确起点，但关键在 Content-ID 绑定和 HTML 引用方式。
为什么 embedFromPath() 返回的字符串必须用 cid: 前缀引用
邮件协议要求内联资源通过 Content-ID 头标识，并在 HTML 中用 cid:xxx 协议引用。Symfony MIME 自动为 embedFromPath() 生成唯一 CID，但你必须手动拼进 <img> 的 src 属性里：
-
embedFromPath()返回的是一个类似的 CID 字符串，不是 URL - HTML 中必须写成
<img src="cid:<123e4567-e89b-12d3-a456-426614174000@example.com>">，少一个或漏掉cid:前缀都会失败 - 如果用
DataPart::fromPath()->asInline()，需调用getContentId()获取 CID，效果等价但更显式
Email 类 vs Part 类：两种构建内嵌图片的路径
直接用 Email 类最简捷，适合单图或少量内嵌资源；用 DataPart + AlternativePart 更灵活，适合复杂结构（比如带文本备选、多图、自定义头）：
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
-
Email::embedFromPath('/path/logo.png')→ 返回 CID，直接插进html()字符串里 -
DataPart::fromPath('/path/logo.png')->asInline()→ 需配合AlternativePart和MultipartRelated手动组装，但可控制 MIME 结构层级 - 混用会出问题：不要对同一个
Email实例既调html()又手动addPart()，MIME 结构可能冲突
常见错误：图片显示为附件或“破损图标”
这几乎总是 MIME 结构或引用不匹配导致的，不是路径或权限问题：
- 用
attachFromPath()代替embedFromPath()→ 图片变成普通附件，不会出现在正文中 - CID 字符串被 HTML 转义（如
<替代）→ 邮件客户端无法解析，显示为缺失图标 - HTML 内容用
text()设置了纯文本部分，但没同步更新内嵌逻辑 → 某些客户端降级显示纯文本时 CID 无效，但结构本身已损坏 - 图片文件不存在或读取失败 →
embedFromPath()不报错，但生成空 CID，HTML 中引用无效
真正容易被忽略的点是：内嵌图片的 MIME 类型必须准确。Symfony MIME 通常能自动推断，但如果文件扩展名缺失或错误（比如 logo 没后缀），它可能设成 application/octet-stream，某些邮箱（如 Outlook）会拒绝渲染。强制指定 MIME 类型比依赖自动识别更稳：DataPart::fromPath('/path/logo', 'logo.png', 'image/png')。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
