Python多行字符串格式化报错：HTML邮件转发%转义符引发类型错误问询

这个坑我之前踩过！问题出在你用的是Python的旧式%格式化语法，而mailto链接里的%20、%40中的%会被Python误识别为格式化占位符（比如%2对应八进制数的占位符%o），但你传入的是字符串，自然就触发了TypeError。下面给你三种靠谱的解决办法：

方法1：转义字符串中的%字符 #

把邮件内容里所有的%都改成%%，这样Python就会把它们当成普通的百分号处理，不会再和格式化占位符混淆。示例代码：

# 原始有问题的字符串
# email_content = """
# <p>点击联系：<a href="mailto:team%40example.com?subject=Question%20About%20Service">发邮件</a></p>
# <p>用户名：%s</p>
# <p>用户ID：%s</p>
# """

# 修改后，把%转义为%%
email_content = """
<p>点击联系：<a href="mailto:team%%40example.com?subject=Question%%20About%%20Service">发邮件</a></p>
<p>用户名：%s</p>
<p>用户ID：%s</p>
"""

# 正常格式化变量
formatted_email = email_content % ("张三", "U12345")

这种方法适合你不想改动格式化方式的场景，只需要转义原有字符串里的%即可。

方法2：使用str.format()新式格式化 #

改用{}作为占位符，完全避开%的冲突问题，mailto链接里的%20、%40可以原封不动保留。示例：

email_content = """
<p>点击联系：<a href="mailto:team%40example.com?subject=Question%20About%20Service">发邮件</a></p>
<p>用户名：{username}</p>
<p>用户ID：{user_id}</p>
"""

# 用format方法传入变量
formatted_email = email_content.format(username="张三", user_id="U12345")

这种方式更清晰，也支持命名占位符，代码可读性更高，是比较推荐的方案。

方法3：使用f-string（Python 3.6+） #

如果你的Python版本在3.6及以上，直接用f-string会更直观，同样用{}嵌入变量，不影响原有mailto链接的转义字符：

username = "张三"
user_id = "U12345"

email_content = f"""
<p>点击联系：<a href="mailto:team%40example.com?subject=Question%20About%20Service">发邮件</a></p>
<p>用户名：{username}</p>
<p>用户ID：{user_id}</p>
"""

这种写法最简洁，变量直接嵌入字符串里，一眼就能看出对应关系，非常适合新代码的编写。

总结一下：如果要兼容旧代码就用方法1；如果是新代码，优先选方法2或3，不仅解决问题，还让代码更易维护。

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