使用DataFrame.to_html发送SMTP邮件时如何设置列宽？

问题根源 #

df.to_html()的col_space参数生成的是<col>标签来定义列宽，但很多邮件客户端（比如Outlook、Gmail）对<col>的width属性支持有限，甚至会被默认样式覆盖，导致设置完全不生效。尤其是包含长URL的列，会自动撑开宽度，破坏整体布局。

解决方案 #

方法1：用Pandas Styler生成带inline样式的HTML（推荐）

Styler可以直接给列添加inline CSS样式，邮件客户端兼容性更好，能精准控制每列宽度：

# 定义各列宽度，最后一列（URL列）设窄，其他指定列按需求加宽
col_widths = ['20px', '20px', '20px', '20px', '20px', '20px', '500px', '20px', '50px', '20px', '100px']

# 创建Styler对象，逐个设置列的宽度和对齐方式
styled_df = df_mail.style
for idx, width in enumerate(col_widths):
    styled_df = styled_df.set_properties(
        subset=df_mail.columns[idx],
        **{'width': width, 'text-align': 'left'}
    )

# 生成最终HTML，关闭索引、设置空值显示
content = styled_df.to_html(index=False, na_rep=" ", border=5)

如果想避免URL列被长链接撑开，还可以加文本截断样式：

# 给最后一列（URL列）添加截断样式，鼠标悬停可查看完整链接
styled_df = styled_df.set_properties(
    subset=df_mail.columns[-1],
    **{
        'width': '100px',
        'white-space': 'nowrap',
        'overflow': 'hidden',
        'text-overflow': 'ellipsis',
        'max-width': '100px'
    }
)

方法2：手动修改生成的HTML，添加inline样式

如果不想用Styler，可以生成基础HTML后，用BeautifulSoup给单元格批量加width样式：

from bs4 import BeautifulSoup

# 先生成基础HTML结构
content = df_mail.to_html(index=False, border=5, justify='left', na_rep=" ")
soup = BeautifulSoup(content, 'html.parser')

col_widths = ['20px', '20px', '20px', '20px', '20px', '20px', '500px', '20px', '50px', '20px', '100px']

# 遍历所有行，给表头和单元格设置宽度
for row in soup.find_all('tr'):
    cells = row.find_all(['th', 'td'])
    for idx, cell in enumerate(cells):
        if idx < len(col_widths):
            cell['style'] = f'width: {col_widths[idx]}; text-align: left;'

content = str(soup)

方法3：优化URL列内容

如果允许修改URL的显示形式，直接缩短或截断文本，从根源上解决列宽问题：

import pandas as pd

# 截断URL并保留可点击链接
def shorten_url(url):
    if pd.notna(url) and isinstance(url, str):
        return f'<a href="{url}" target="_blank">{url[:30]}...</a>'
    return " "

# 替换最后一列的内容
df_mail.iloc[:, -1] = df_mail.iloc[:, -1].apply(shorten_url)

# 生成HTML时关闭转义，避免链接被解析成纯文本
content = df_mail.to_html(
    col_space=col_widths, 
    index=False, 
    border=5, 
    justify='left', 
    na_rep=" ", 
    escape=False
)

注意事项 #

• 邮件客户端普遍只支持inline CSS，尽量避免使用外部样式表或<style>标签；
• 测试时多在目标邮件客户端（比如Outlook、Gmail）预览，不同客户端的样式兼容性存在差异。

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