---
title: Odoo 邮件模板改为纯文本格式的运维方法
description: 面向企业 IT 运维，说明在 Odoo 中将邮件模板输出改为纯文本的适用场景、准备与风险、处理步骤、验证方法、回退建议及常见问题。涉及模板编辑、邮件正文类型选择与测试环境验证，所有环境参数使用占位符，破坏性操作前须备份数据库与自定义模块。
url: "https://www.lanever.com/docs/odoo-%e9%82%ae%e4%bb%b6%e6%a8%a1%e6%9d%bf%e6%94%b9%e4%b8%ba%e7%ba%af%e6%96%87%e6%9c%ac%e6%a0%bc%e5%bc%8f%e7%9a%84%e8%bf%90%e7%bb%b4%e6%96%b9%e6%b3%95/"
updated: "2026-10-12"
category: Odoo
---

# Odoo 邮件模板改为纯文本格式的运维方法

> **参考来源与致谢**
>
>
>
> - **引用来源：**[how to change odoo email format to simple text](https://www.google.com/search?q=how+to+change+odoo+email+format+to+simple+text&newwindow=1&sxsrf=AOaemvI78dyQkI3FJ1XvYqKpGyYNf8miiA:1643024383087&source=lnt&tbs=qdr:y&sa=X&ved=2ahUKEwj-zdflpsr1AhVuMOwKHeshD5AQpwV6BAgBEB0&biw=2160&bih=1307&dpr=1)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

企业使用 Odoo 发送通知、报价、发票或工单邮件时，若收件方邮件客户端渲染 HTML 异常、被反垃圾策略拦截，或业务要求统一为纯文本通知，可将指定邮件模板的输出改为纯文本。此调整只影响模板渲染结果，不改变 Odoo 的邮件发送机制。

## 准备与风险

- 确认 Odoo 版本与部署方式（在线版或自建），不同版本界面路径可能不同，具体以对应版本官方文档为准。
- 准备测试环境，使用与生产一致的数据库副本和邮件模板副本进行验证。
- 操作前备份数据库与自定义模块目录，记录原始模板内容，便于回退。
- 纯文本邮件不支持按钮、图片、样式和跟踪像素，可能影响营销类邮件的点击统计。
- 不要在生产环境直接修改正在使用的系统模板，建议先复制模板再调整。

## 处理步骤

1. 进入设置中的技术功能菜单，打开邮件模板列表。若界面未显示技术菜单，需先启用开发者模式。
2. 找到目标模板，复制一份作为测试模板，避免直接改动系统模板。
3. 在模板编辑界面查看正文字段。Odoo 模板正文通常使用 HTML 或 QWeb 语法，纯文本化有两种通用做法：一是将正文改为不含标签的纯文本内容；二是保留 QWeb 变量但去掉 HTML 标签与样式。
4. 若模板正文由 QWeb 渲染，检查其中是否包含 `t-esc`、`t-out` 等输出指令。纯文本场景下应避免输出 HTML 片段，必要时对变量做转义处理。
5. 检查模板的邮件正文类型或子类型设置，确认发送时不会强制套用 HTML 包装。部分版本会在邮件发送环节附加默认布局，需要一并调整。
6. 保存模板后，在测试环境用测试收件地址发送一封邮件，确认内容为纯文本。

> 修改系统模板或邮件服务器参数属于影响面较大的操作。请先在测试环境验证，确认无误后再考虑生产变更，并保留可回退的备份。

## 验证方法

- 查看收件箱中邮件的原始内容，确认不含 HTML 标签与内联样式。
- 在 Odoo 的邮件记录中检查正文存储内容，确认与预期一致。
- 使用不同邮件客户端（桌面端、网页端、移动端）分别查看，确认显示正常。
- 检查模板中的变量是否被正确替换，例如客户名称、单据编号等占位内容。

## 回退建议

- 若结果不符合预期，恢复备份的数据库或还原原始模板内容。
- 若仅修改了模板副本，删除副本并重新启用原模板即可。
- 若调整过邮件服务器或发送参数，逐项恢复原值并重新测试发送。

## 常见问题

- 邮件仍显示 HTML：检查是否还有其他模板或邮件布局在发送时被套用。
- 变量未替换：确认 QWeb 表达式语法正确，且模板上下文包含所需字段。
- 纯文本邮件被判定为垃圾邮件：检查发件域配置、SPF 与 DKIM 等基础邮件认证设置，具体配置请查阅对应版本文档。
- 多语言环境下内容不一致：确认各语言版本的模板正文均已调整。
- 升级后模板被覆盖：升级前备份自定义模板，升级后重新核对。
