使用Python发送HTML邮件时如何加载style.css外部样式

核心原因 #

邮件客户端的资源加载逻辑和网页浏览器、本地文件直接打开的场景完全不同，所有主流客户端出于安全策略，都会直接拦截、移除HTML邮件中引用的外部资源，包括外链CSS、外链脚本、甚至无白名单的外链图片。很多人在本地直接双击打开template.html时样式显示正常，就误以为模板没有问题——实际上你在template.html里用<link>引入本地style.css的写法，在客户端解析邮件时会被直接删掉，根本没有权限读取你本地电脑上的样式文件，自然所有样式都不生效，这部分问题和你当前Python的SMTP发送代码逻辑没有关系。

具体修复方案 #

• 方案1（全客户端兼容，推荐）：全量内联CSS样式
  完全去掉外部CSS引入的写法，把style.css里的每一条规则，直接绑定到对应HTML元素的style属性上。比如原来CSS里定义.title {color: #222; font-size: 18px;}，就要写成<h1 class="title" style="color: #222; font-size: 18px;">邮件标题</h1>。
  如果模板结构复杂，手动改内联样式效率太低，可以在Python的发送逻辑里加一层CSS处理：先读取本地style.css的内容，自动把样式规则匹配到HTML的对应元素上，生成最终带内联样式的HTML内容后再传给MIMEText对象。

• 方案2（临时可用，兼容性一般）：把CSS直接内嵌到HTML文档内部
  删掉template.html里引入外部style.css的<link>标签，把style.css的全部内容，直接写在HTML文档<head>区域的<style type="text/css">标签里。
  对应可以修改现有Python代码的HTML读取逻辑，不用手动改模板的样式，示例代码片段：

  # 读取本地的CSS文件内容
  style_css = open("style.css", encoding="utf-8").read()
  # 读取HTML模板，把CSS内容替换到模板预留的样式占位位置
  html_template = open("template.html", encoding="utf-8").read()
  final_html = html_template.replace("/* 替换为本地CSS内容 */", style_css).format(Name="swix")
  part2 = MIMEText(final_html, 'html')
  

  注意：这种方法在部分老旧的桌面端邮件客户端（比如旧版Outlook）里，依然会出现样式被截断、解析失效的问题，不能保证全平台兼容。

避坑提醒 #

• 别想着把style.css当邮件附件发出去解决问题，附件内容是独立的文件，HTML邮件部分根本不会自动加载附件里的样式，完全没用。
• 尽量少用复杂CSS语法，比如伪类选择器、跨多层级的后代选择器，这类语法在邮件客户端的简陋解析引擎里支持度极低，很容易出现样式丢失。

内容的提问来源于stack exchange，提问作者Swix