导言
货币字段在 Odoo 中既常见又容易被误用。表面上它像数字、数据库里以浮点数保存，但它的行为受货币设置驱动，和普通 Float 字段有本质区别。理解这个差别后，你就不会再用普通 Float 来处理财务金额了。
每当你在销售单、发票或商品价格中看到带货币符号和精度控制的金额，那就是 Monetary 字段在工作。它遍布 Odoo 的数据模型，负责显示格式、精度和舍入等关键细节。
本指南面向开发者、实施顾问和对技术细节感兴趣的业务用户。无论你是看教程学习字段用法、开发自定义模块，还是在排查金额舍入问题，这篇文章都是你理解 Monetary 字段机制的实用参考。
什么是 Odoo 的货币（Monetary）字段？
在 Odoo 框架中，fields.Monetary 是专门用于表示货币数值的字段类型。它适合保存价格、金额、合计、预算等与货币相关的数值。
Monetary 与普通 Float 的关键差别在于它必须和某个货币记录关联。字段始终“知道”自己对应的是哪种货币，并以该货币的精度和舍入规则来决定显示和四舍五入行为。
在界面上的表现
在 Odoo 界面中，Monetary 字段会根据关联货币的设置格式化显示。例如设为欧元会显示为类似 “€ 1,234.50” 的样式；设为美元则显示为 “$ 1,234.50”。小数位数和符号位置由对应的货币记录决定。
该字段在表单视图中可编辑、在列表视图中显示整齐，并能无缝用于数据透视或财务报表。对最终用户来说，格式问题被 Odoo 透明处理，无需额外干预。
底层数据类型说明
在数据库层面，Monetary 字段以 PostgreSQL 的双精度浮点数存储。货币信息不与数值共列；数值列与货币通过模型上另一个 Many2one 字段（指向 res.currency）关联。
这种将金额值与货币分离的设计是有意为之：它让数据结构更清晰，也便于在不改变数值列的情况下调整记录所用的货币。
字段的工作方式概述
掌握 Monetary 字段的内部机制，能帮助你正确使用它，避免在自定义开发中常见的舍入和显示问题。
currency_field 参数的作用
每个 Monetary 字段都必须指明配套的 Many2one 货币字段。默认情况下，Odoo 在同一模型上查找名为 currency_id 的字段；也可以通过 currency_field 参数指定其他字段：
amount = fields.Monetary(string='Amount', currency_field='currency_id')如果某条记录没有设置货币字段，Odoo 会退回到公司货币作为显示和格式化的备选。这避免了程序报错，但在多币种场景下会导致格式化不正确。因此应始终显式声明货币字段。
关于舍入与精度
Monetary 与 Float 的另一个重要区别是舍入策略由 res.currency 控制。每种货币记录定义了小数位数和舍入步长，Odoo 在读取或显示 Monetary 值时会自动应用这些规则。
举例来说，数据库里存着 1.2349999，但如果该字段绑定的是欧元，界面上会按欧元的精度显示为 1.23，而不是 1.235 或 1.23499。对于税务计算、发票合计和对账，这种一致的舍入行为至关重要。若用普通 Float，会带来难以追踪的四舍五入差异。
与 Odoo ORM 的交互
在 Odoo 的 ORM 中，读取 Monetary 字段会得到一个 Python 的 float。配套货币字段提供了上下文信息。在 Python 代码中处理 Monetary 值时，建议使用货币记录的 round() 方法来保持精度：
rounded_value = self.currency_id.round(self.amount)这样可以避免在多行合计或迭代计算中出现的浮点误差积累问题。
在 QWeb 报表中的使用
在 QWeb 模板里，Monetary 字段配合专用小部件即可在 PDF 和网页报表中得到正确格式化：
<span t-esc="record.amount"
t-options='{"widget": "monetary", "display_currency": record.currency_id}'/>这样不论记录使用哪种货币，生成的文档都会显示正确的货币符号和小数格式。
典型的业务应用场景
下面通过五个实际场景说明 Monetary 字段在标准模块中的常见用途，以及它为何重要。
1. 销售：商品价格与订单合计
销售单和订单行上的 price_unit、price_subtotal、amount_total 都是 Monetary 字段。它们会根据客户订单上选择的货币自动显示和舍入，哪怕该货币与公司货币不同。
例如销售人员为公司以 EUR 为经营货币的公司创建一张以 USD 计价的订单，Monetary 字段会在该订单上下文中正确处理显示和舍入，从而避免人工干预。
2. 会计：发票金额与税额行
会计模块里发票各列（amount_untaxed、amount_tax、amount_total）均为 Monetary 字段。发票上设置的货币决定这些金额的舍入规则。
这不是小细节：税额舍入错误会导致分录不平衡，给对账带来很大麻烦。货币感知的 Monetary 字段能在数据层面避免此类问题。
3. CRM：商机的预期收入
CRM 中的 expected_revenue 是 Monetary 字段。销售团队可按潜在客户的货币记录金额，报表与仪表盘再将这些值换算为公司货币用于汇总与预测分析。
正是因为 Monetary 字段携带货币上下文，这种跨货币的管线分析才能顺利进行。
4. 采购：供应商价格与采购订单
采购订单使用 Monetary 字段来保存单价与合计，关联到供应商约定的货币。不论供应商以日元还是欧元开票，Monetary 字段都能处理精度和显示，采购人员无需手工处理。
5. 自定义字段：预算与目标追踪
在项目、部门或自定义模型上添加预算、目标收入或费用上限时，应该使用 Monetary 字段。它天然与公司货币集成，表单、列表、报表和导出都能正确展示。
用 Float 实现虽可行，但一旦涉及多币种就会出现格式不一致和舍入问题。
如何创建或自定义该字段
向模型添加 Monetary 字段有两种常见方法：无代码的 Odoo Studio 或通过自定义 Python 模块获得完全控制。
使用 Odoo Studio
Odoo Studio 在字段创建面板中提供 Monetary 类型。Studio 在模型上若不存在货币字段，会自动创建一个 currency_id。这对大多数常见场景已足够，省去编写代码的工作量。
需要注意的是：Studio 创建的字段会带有 x_ 前缀（例如 x_studio_budget）。如果模型已有 currency_id，新字段会复用该字段；否则 Studio 会新增一个。若同一模型上有多个期望使用不同货币的 Monetary 字段，应在上线前仔细检查这些共享货币字段的配置。
对于简单需求，Studio 是为非开发人员快速创建字段的最佳途径。
技术实现：Python 中的字段定义
在自定义模块中添加 Monetary 字段通常需要同时声明该字段和对应的货币 Many2one 字段。这是 Odoo 中定义字段的标准做法：
from odoo import fields, models
class ProjectTask(models.Model):
_inherit = 'project.task'
x_budget = fields.Monetary(
string='Budget',
currency_field='x_budget_currency_id',
)
x_budget_currency_id = fields.Many2one(
comodel_name='res.currency',
string='Budget Currency',
default=lambda self: self.env.company.currency_id,
)将公司货币设为默认值通常是对内部字段的实用选择，能避免新建记录时货币字段为空，从而导致 UI 丢失货币符号或格式。
计算型 Monetary 字段
Monetary 字段也适合用作计算字段。如果需要对多行金额求和或应用公式，采用 Monetary 类型并在 compute 方法中赋值是常见模式：
x_total_budget = fields.Monetary(
string='Total Budget',
currency_field='currency_id',
compute='_compute_total_budget',
store=True,
)
@api.depends('x_line_ids.x_amount')
def _compute_total_budget(self):
for record in self:
record.x_total_budget = sum(record.x_line_ids.mapped('x_amount'))如果计划在列表视图或报表中按该字段筛选、排序或汇总，请务必设置 store=True。未存储的计算字段无法用于 ORM 域过滤或基于 SQL 的视图，这是构建自定义仪表盘时常见的困惑点。
通过 API 添加 Monetary 字段
如果需要通过 XML-RPC 等接口以脚本方式创建字段（例如远程配置脚本），可以通过 ir.model.fields 创建 Monetary 字段：
models.execute_kw(ODOO_DB, uid, ODOO_API_KEY,
'ir.model.fields', 'create',
[{
'name': 'x_budget',
'field_description': 'Budget',
'model_id': model_id,
'ttype': 'monetary',
'currency_field': 'currency_id',
'state': 'manual',
}]
)这是 Odoo 可定制性工具集的一部分，适合在需要自动化或大规模配置场景中使用。
最佳实践要点
掌握一些使用规范，能让 Monetary 字段在项目中表现稳定并减少后续问题。下面是关键实践要点。
1. 不要用 Float 存储金钱
这是最重要的规则：任何表示价格、金额、合计或预算的字段都应使用 fields.Monetary。Float 缺乏货币感知，无法在多币种环境下正确舍入。Monetary 的存在正是为了解决这个问题。
2. 显式声明货币字段
不要依赖 Odoo 的默认回退，除非模型上确实存在 currency_id。在定义 Monetary 字段时应明确设置 currency_field，并声明对应的 Many2one 指向 res.currency，以避免在多币种环境下出现隐式回退。
3. 设置货币默认值
对于几乎总是使用公司货币的内部字段，给货币字段设置默认值：default=lambda self: self.env.company.currency_id。这样新建记录时不会出现空货币，UI 也会正常显示货币符号与格式。
4. 对需搜索的计算型字段使用 store=True
若要在 ORM 域、报表或列表中筛选/排序计算结果，请设置 store=True，否则无法参与基于数据库的查询与聚合。
5. 复杂计算中使用 currency.round()
在 Python 中对 Monetary 值进行多步计算时，在每个关键步骤调用 self.currency_id.round(value)，而不是只在最后一步四舍五入。这样能避免浮点误差在多次运算中累积，保证总额一致。
6. 在跨币种报表中要有明确策略
聚合来自不同货币的 Monetary 值时，切勿直接相加。先用 res.currency.compute() 将各值转换为统一货币，或在报表层面限定货币。直接混合相加会产生在字段层面看似正确但从财务角度毫无意义的数字。
常见错误与陷阱
即便是资深 Odoo 开发者，也会在 Monetary 字段上踩坑。以下是常见问题与规避方法。
常见陷阱一：缺失货币字段
最常见的问题是忘记同时创建货币的 Many2one 字段。如果模型上没有 currency_id，Odoo 在某些情况下会悄然回退到公司货币，在另一些情况下则会报错。无论如何，始终和 Monetary 字段一起创建货币字段以避免隐藏问题。
常见陷阱二：不同用途的两个金额共用同一个货币字段
如果模型上有两个本应使用不同货币的 Monetary 字段（例如客户价以 EUR、供应商成本以 USD），不能共用一个 currency_id。每个金额域都应拥有自己的货币引用，否则一处货币设置会影响到所有共享该字段的金额，导致数据与界面混乱。
常见陷阱三：跨币种汇总时的舍入差异
把来自不同货币的金额直接相加会得到看起来“错误”的总额，因为你把欧元数和美元数当作同一单位相加。在多币种公司中，这类问题经常导致错误报表。务必先统一货币再做汇总。
常见陷阱四：使用浮点做精确等值比较
用精确等号（如 amount = 10.0）去查询 Monetary 字段可能会漏掉记录，因为浮点在数据库中的存储并非精确匹配。应使用范围查询（>= 与 <=）并带上小幅容差，或在比较前对值做货币舍入。
常见陷阱五：导入数据时忽视货币舍入
通过 CSV 或 XML-RPC 导入 Monetary 值时，数据会按提供的数值存储，不会自动按货币精度舍入。若源数据小数位超过目标货币允许的位数，导入后显示可能与预期不同并引发合计上的小偏差。建议在导入脚本或数据准备阶段先进行货币舍入。
总结
货币字段表面上看很简单，但它与货币记录的紧密关联带来了很多关键功能：一致的舍入规则、可靠的格式化，以及在整个 Odoo 界面和报表引擎中的货币感知显示。
只要正确使用——总是配套明确的货币字段、绝不以 Float 替代——就能避免一类在生产环境中难以定位的微妙错误。Odoo 的数据模型之所以围绕这种字段设计，是有充分理由的。
无论你是在跟随开发指南、自定义标准模块，还是从零构建系统，合理设计 Monetary 字段都是确保 Odoo 正确处理金钱问题的基础性决定之一。
需要我们协助您的 Odoo 部署吗？
在 Dasolo，我们为各类企业提供 Odoo 实施、定制与优化服务。无论是理清数据模型、制定字段策略、支持多币种，还是从头部署全套 Odoo，我们的团队都具备深入的技术与业务经验来把事情做对。
如果你对 Monetary 字段或 Odoo 的其他模块有任何疑问，我们很乐意提供帮助。 联系我们 让我们聊聊你正在建设的系统与需求。