企业官网建设流程全解析

1. 从一个真实的业务需求说起：为什么我们总在“改”Odoo

最近在给一个客户做Odoo的二次开发，他们提了一个很典型的需求：现有的销售订单（sale.order）表单上，客户希望增加一个“项目紧急程度”的字段，并且根据这个字段的值，自动高亮显示订单行。听起来很简单，对吧？但如果你直接去修改Odoo标准模块sale里的views/sale_order_views.xml文件，那就踩进了第一个大坑。下次Odoo版本升级，你的修改会被无情地覆盖，所有定制化工作付诸东流。

这就是Odoo开发中永恒的核心命题：如何在不动原模块“一砖一瓦”的前提下，实现功能的扩展、修改甚至重写？答案就是“继承”（Inheritance）。Odoo的继承机制是其模块化架构的基石，它允许你像搭积木一样，在现有功能之上构建新的功能，而无需修改底层代码。这不仅关乎代码的整洁，更关乎项目未来的可维护性和升级的平滑性。

今天，我们就抛开那些抽象的概念，直接深入到代码和视图层面，手把手拆解Odoo的继承与扩展。我会结合我这些年趟过的坑，告诉你什么时候该用哪种继承方式，视图继承的xpath到底怎么写才不报错，以及如何让你的新模块既干净又强大。

2. 理解Odoo继承的“道”与“术”：模型、字段与方法的扩展

在动手写代码之前，我们必须先理解Odoo继承的几种类型。这就像木匠的工具箱，你知道什么时候该用锯子，什么时候该用刨子。

2.1 类继承（Classical Inheritance）：最直接的“是什么”

类继承，也叫_inherit，用于扩展或修改一个现有的模型。你创建的新模块模型，直接声明继承自某个已存在的模型。这是最常用的一种。

核心场景：为现有模型添加新字段、覆盖现有方法、添加新的约束或计算字段。

让我们用代码说话。假设我们要给标准的res.partner（客户/供应商）模型加一个“客户等级”字段。

错误的做法（直接修改原模块）：找到odoo/addons/base/models/res_partner.py就开改。这是自杀式行为。

正确的做法（创建新模块）：

1. 新建一个模块目录，例如my_partner_extension。
2. 创建模型文件models/partner.py：

# models/partner.py from odoo import models, fields, api class ResPartner(models.Model): # 关键在这里：_inherit 指定了要继承的原始模型 _inherit = 'res.partner' # 添加新字段 customer_rank = fields.Selection( selection=[('basic', '普通'), ('vip', 'VIP'), ('vvip', '尊享VIP')], string='客户等级', default='basic' ) # 覆盖（重写）父类的方法 @api.model def create(self, vals): # 在创建前做一些事情，例如自动根据公司名生成客户等级逻辑（示例） if vals.get('name') and '科技' in vals.get('name'): vals['customer_rank'] = 'vip' # 必须调用super()来执行原始的逻辑 return super(ResPartner, self).create(vals) # 添加一个新的方法 def send_vip_greeting(self): self.ensure_one() # 发送VIP问候邮件的逻辑 # ... return True

关键点解析：

• _inherit = ‘res.partner’：这行代码告诉Odoo，我这个ResPartner类不是全新的，它是在原有res.partner模型基础上的扩展。Odoo会在运行时将两个类合并。
• super()的调用：在重写方法时，几乎总是需要调用super()。除非你的意图是完全取代原方法的行为。不调用super()会导致原始逻辑丢失，引发各种诡异问题。
• 字段添加：直接像在普通模型中一样定义字段即可，Odoo会自动将它们合并到原模型中。

2.2 原型继承（Prototypal Inheritance）：创建一个“变种”

原型继承使用_inherit和_name的组合。它基于一个现有模型创建一个全新的模型。新模型拥有父模型的所有字段和方法，但它们在数据库中是两个独立的表。

核心场景：你需要一个和现有模型高度相似，但又是独立实体的模型。例如，从product.template（产品模板）继承出service.template（服务模板）。

# models/service.py from odoo import models, fields class ServiceTemplate(models.Model): _name = 'service.template' # 新模型的唯一标识 _inherit = 'product.template' # 继承自产品模板 _description = '服务模板' # 可以添加服务特有的字段 service_duration = fields.Float(string='服务时长（小时）') is_online_service = fields.Boolean(string='在线服务') # 可以覆盖继承来的字段属性 # 例如，所有服务类型的“产品类型”固定为‘service’ type = fields.Selection(selection_add=[('service', '服务')], ondelete={'service': 'set default'})

关键点解析：

• _name和_inherit同时存在：这告诉Odoo创建一个名为service.template的新模型，并以product.template为蓝本。
• 独立表：数据库中会有一张名为service_template的表，它包含了product.template的所有字段（通过Odoo的机制映射）以及自己新增的字段。
• 使用场景更特定：当你需要逻辑上的严格区分时使用。比如，你不希望服务和实物产品在列表视图、菜单或业务规则上混在一起。

2.3 委托继承（Delegation Inheritance）： “我有一个…”

委托继承使用_inherits属性。它实现的是对象组合（“has-a”关系），而非类继承（“is-a”）。子模型实例“拥有”一个父模型实例，并通过委托来访问父模型的字段。

核心场景：扩展现有模型，但希望保持数据的独立性。最经典的例子是res.users对res.partner的继承。每个用户（User）都是一个伙伴（Partner），但用户有自己额外的信息。

# 这是一个概念示例，Odoo标准模块已实现 # models/extended_user.py from odoo import models, fields class ExtendedUser(models.Model): _name = 'extended.user' _inherits = {'res.partner': 'partner_id'} # 委托继承 partner_id = fields.Many2one('res.partner', string='关联伙伴', required=True, ondelete='cascade') # 添加用户特有的字段 internal_phone = fields.Char(string='内部分机号') department = fields.Char(string='部门')

关键点解析：

• _inherits是一个字典：{‘父模型名’: ‘子模型中用于链接的Many2one字段名’}。
• 数据存储：当创建一个extended.user记录时，Odoo会同时创建一条res.partner记录。extended.user记录只存储自己的字段和指向res.partner记录的partner_id。
• 字段访问：你可以直接通过extended_user_record.name访问伙伴的姓名，Odoo会自动通过委托机制从关联的res.partner记录中获取。
• 何时使用：当你需要复用另一个模型的完整功能（包括其所有视图、权限、业务逻辑），但又需要保持数据实体分离时。不如类继承常用，但理解它有助于读懂Odoo标准代码。

实操心得：选择继承类型的“直觉”90%的情况下，你用的是类继承（_inherit）。当你只是想给现有模型加点东西或改点东西时，就用它。 当你觉得“我需要一个和XX很像，但完全是另一个东西”的时候，考虑原型继承（_name+_inherit）。 委托继承（_inherits）在标准模块中很常见，但在自定义开发中较少，除非你在设计一个非常复杂的模型关系。拿不准时，先用类继承。

3. 视图继承的实战：精准定位与优雅修改

模型继承搞定了数据和逻辑，但用户是通过界面（视图）来交互的。视图继承让你可以修改任何现有视图，而无需复制整个视图文件。

Odoo的视图继承核心是<inherit>标签和xpath表达式。xpath是一种用于在XML中定位节点的查询语言，虽然听起来有点技术性，但用起来就像“地图坐标”。

3.1 视图继承的基本结构

首先，在你的新模块中创建视图文件，例如views/partner_view.xml。

<?xml version="1.0" encoding="utf-8"?> <odoo> <data> <!-- 继承 res.partner 的表单视图 --> <record id="view_partner_form_inherit" model="ir.ui.view"> <field name="name">res.partner.form.inherit.my.module</field> <field name="model">res.partner</field> <field name="inherit_id" ref="base.view_partner_form"/> <!-- 关键：指定继承哪个视图 --> <field name="arch" type="xml"> <!-- 在这里使用 xpath 进行修改 --> <xpath expr="//field[@name='name']" position="after"> <field name="customer_rank" widget="radio"/> </xpath> <!-- 更常见的简写语法 --> <field name="email" position="after"> <field name="internal_phone"/> </field> <!-- 在表单最底部添加一个新分组页签 --> <xpath expr="//sheet" position="inside"> <div class="oe_button_box" name="button_box"> <!-- 可以在这里添加按钮 --> </div> <footer> <button name="send_vip_greeting" string="发送VIP问候" type="object" class="btn-primary"/> </footer> </xpath> </field> </record> </data> </odoo>

关键点解析：

• inherit_id：通过ref属性指向你要继承的原始视图的XML ID。这是视图继承的“锚点”。
• arch字段：这里包含了所有你对原始视图结构的修改指令。
• xpathvs 简写：
  • xpath expr=”…”：功能最强大，可以定位到任何节点。//表示在整个文档中查找，[@name=‘xxx’]是属性选择器。
  • <field name=”email” position=”after”>：这是最常见的简写。Odoo会将其解释为xpath expr=”//field[@name=’email’]”。仅当目标节点有唯一的name属性时才适用。

3.2position属性的五种武器

position属性告诉Odoo，找到节点后，你想怎么“处置”它。这是视图继承的灵魂。

1. inside（默认）：将内容插入到目标节点的内部末尾。

   <xpath expr="//div[@class='oe_button_box']" position="inside"> <button name="my_action" string="自定义动作"/> </xpath>

   • 用途：向一个容器（如group、div、sheet）内添加新元素。

2. after：将内容插入到目标节点之后（作为兄弟节点）。

   <field name="phone" position="after"> <field name="mobile"/> </field>

   • 用途：在某个字段后面添加新字段。最常用。

3. before：将内容插入到目标节点之前。

   <field name="street" position="before"> <label for="country_id" string="国家"/> <field name="country_id"/> </xpath>

   • 用途：在某个字段前面添加内容。

4. replace：替换整个目标节点。小心使用！

   <field name="website" position="replace"> <field name="website" readonly="1"/> <!-- 将网站字段改为只读 --> </field>

   • 用途：修改一个现有元素的属性，或者完全替换一个复杂的结构。注意：替换时，新节点通常需要保持相同的核心属性（如name）。

5. move：将目标节点移动到另一个xpath表达式定位的位置。

   <xpath expr="//field[@name='child_ids']" position="move"> <xpath expr="//field[@name='category_id']" position="after"/> </xpath>

   • 用途：调整界面元素的顺序。比较进阶，但非常强大。

踩坑实录：xpath定位失败的那些事儿视图继承90%的错误来自于xpath写错了，找不到节点。

• 坑1：name属性不唯一。原视图中有两个<field name=”date”>，一个在抬头，一个在行内。你的简写<field name=”date” position=”after”>会作用于第一个，可能不是你想要的。务必使用更精确的xpath，例如//field[@name=‘date’ and ancestor::div[@class=‘oe_title’]]。
• 坑2：视图结构因模块加载顺序改变。模块A修改了视图，模块B又基于A修改后的视图做继承。如果B在A之前加载，B的继承就会失败。解决方案：在模块的__manifest__.py中用‘depends’声明依赖关系，确保加载顺序。
• 坑3：替换（replace）时改变了关键结构。比如你把一个<tree>视图的@editable属性去掉了，但模型层没有相应调整，可能导致界面错误。替换前，最好先看看原节点的完整结构。

3.3 继承列表视图（Tree）和搜索视图（Search）

原理和表单视图一模一样，只是定位的目标不同。

继承列表视图，添加一列：

<record id="view_partner_tree_inherit" model="ir.ui.view"> <field name="inherit_id" ref="base.view_partner_tree"/> <field name="arch" type="xml"> <xpath expr="//field[@name='phone']" position="after"> <field name="customer_rank"/> </xpath> </field> </record>

继承搜索视图，添加筛选条件：

<record id="view_partner_filter_inherit" model="ir.ui.view"> <field name="inherit_id" ref="base.view_res_partner_filter"/> <field name="arch" type="xml"> <!-- 在搜索框的筛选条件区域添加 --> <xpath expr="//filter[@name='company']" position="after"> <filter name="filter_by_rank" string="VIP客户" domain="[('customer_rank', '=', 'vip')]"/> </xpath> <!-- 在搜索框的搜索字段区域添加 --> <field name="email" position="after"> <field name="customer_rank"/> </field> </field> </record>

4. 构建一个完整的新模块：从理论到实践

理解了继承的“零件”后，我们来组装一辆“车”。我们将创建一个完整的模块my_partner_extension，实现前面提到的所有功能。

4.1 模块结构

my_partner_extension/ ├── __init__.py ├── __manifest__.py ├── models/ │ ├── __init__.py │ └── partner.py # 包含我们扩展的 ResPartner 类 └── views/ └── partner_view.xml # 包含所有视图继承的定义

4.2 关键文件详解

__manifest__.py：模块的“身份证”和“说明书”。

{ 'name': "客户扩展模块", 'version': '16.0.1.0.0', 'category': 'Sales', 'summary': '为合作伙伴模型添加客户等级和自定义功能', 'description': """ 本模块扩展了Odoo标准的合作伙伴(res.partner)模型。 功能包括： - 添加客户等级字段（普通/VIP/尊享VIP） - 在销售订单等相关表单中显示该字段 - 提供发送VIP问候邮件的功能 """, 'author': "你的名字/公司", 'website': "https://www.yourwebsite.com", 'depends': ['base', 'sale'], # 关键：声明依赖，确保在base和sale模块之后加载 'data': [ 'views/partner_view.xml', # 声明视图文件 ], 'demo': [], 'installable': True, 'application': False, 'auto_install': False, 'license': 'LGPL-3', }

• depends：至关重要。这里声明了本模块正常运行所依赖的其他模块。Odoo会根据这个顺序加载模块。因为我们继承了sale模块的视图，所以必须依赖它。

models/__init__.py：

from . import partner

models/partner.py：（内容同2.1节，略）

views/partner_view.xml：（综合示例）

<?xml version="1.0" encoding="utf-8"?> <odoo> <data> <!-- 继承合作伙伴表单视图 --> <record id="view_partner_form_inherit" model="ir.ui.view"> <field name="inherit_id" ref="base.view_partner_form"/> <field name="arch" type="xml"> <!-- 在“名称”字段后添加“客户等级”单选框 --> <field name="name" position="after"> <field name="customer_rank" widget="radio"/> </field> <!-- 在“电话”字段后添加“内部分机号” --> <field name="phone" position="after"> <field name="internal_phone"/> </field> <!-- 在表单底部添加一个自定义按钮 --> <xpath expr="//sheet" position="before"> <div class="oe_button_box" name="button_box"> <button name="send_vip_greeting" string="发送问候" type="object" class="oe_stat_button" icon="fa-envelope"> <field name="customer_rank" widget="statinfo" string="等级"/> </button> </div> </xpath> </field> </record> <!-- 继承合作伙伴列表视图 --> <record id="view_partner_tree_inherit" model="ir.ui.view"> <field name="inherit_id" ref="base.view_partner_tree"/> <field name="arch" type="xml"> <field name="phone" position="after"> <field name="customer_rank"/> </field> </field> </record> <!-- 继承合作伙伴搜索视图 --> <record id="view_partner_filter_inherit" model="ir.ui.view"> <field name="inherit_id" ref="base.view_res_partner_filter"/> <field name="arch" type="xml"> <xpath expr="//filter[@name='active']" position="after"> <filter name="filter_vip" string="VIP客户" domain="[('customer_rank','=','vip')]"/> <filter name="filter_vvip" string="尊享VIP" domain="[('customer_rank','=','vvip')]"/> </xpath> <field name="phone" position="after"> <field name="customer_rank" filter_domain="[('customer_rank','ilike',self)]"/> </field> </field> </record> <!-- 继承销售订单表单视图，将客户等级字段显示在客户信息附近 --> <record id="view_sale_order_form_inherit" model="ir.ui.view"> <field name="inherit_id" ref="sale.view_order_form"/> <field name="arch" type="xml"> <!-- 定位到销售订单的客户信息区域 --> <xpath expr="//div[@name='partner_shipping_id']/.." position="before"> <label for="partner_id_customer_rank" string="客户等级"/> <field name="partner_id.customer_rank" readonly="1" class="oe_inline"/> </xpath> </field> </record> </data> </odoo>

4.3 模块的安装与调试

1. 放置模块：将my_partner_extension文件夹放到Odoo的插件路径下（通常是addons/目录）。
2. 更新应用列表：在Odoo开发者模式下，进入“应用” -> “更新应用列表”。
3. 搜索并安装：搜索“客户扩展模块”并安装。
4. 调试视图：如果视图没有按预期显示，进入开发者模式（?debug=1），然后：
   • 在表单视图上，点击“调试图标（小虫子）” -> “编辑视图：表单”。这会打开视图结构编辑器，你可以看到最终渲染的视图XML，检查你的xpath是否生效，定位是否准确。
   • 查看日志。Odoo服务端日志（通常终端或日志文件）会详细记录视图加载时的错误，如xpath找不到节点。

5. 进阶技巧与避坑指南

掌握了基础，我们来看看那些能让你的开发更高效、更稳健的进阶知识。

5.1 使用attrs属性实现条件显示/必填/只读

这是Odoo视图中最强大的动态特性之一。你可以让一个字段的可见性、是否必填、是否只读，取决于另一个字段的值。

<field name="internal_phone" attrs="{'invisible': [('customer_rank', '!=', 'vip')], 'required': [('customer_rank', '=', 'vvip')]}"/>

• invisible：当customer_rank不是vip时，该字段隐藏。
• required：当customer_rank是vvip时，该字段必填。
• 还可以用readonly。

避坑点：attrs中的域（domain）表达式，其左值必须是当前视图所在模型的字段。如果你需要根据关联模型的字段来控制，通常需要在当前模型中创建一个相关的计算字段（related字段）。

5.2 继承并修改ir.actions.act_window上下文或域

有时你不仅想改视图，还想改打开这个视图的“动作”行为，比如默认的筛选条件。

<!-- 修改“客户”菜单动作，默认只显示VIP客户 --> <record id="action_partner_form_inherit" model="ir.actions.act_window"> <field name="name">客户</field> <field name="res_model">res.partner</field> <field name="inherit_id" ref="base.action_partner_form"/> <field name="context">{'search_default_filter_vip': 1}</field> <!-- 默认启用名为filter_vip的筛选器 --> <!-- 或者使用 domain --> <!-- <field name="domain">[('customer_rank', 'in', ['vip', 'vvip'])]</field> --> </record>

5.3 处理多模块继承冲突

当多个模块试图继承并修改同一个视图的同一位置时，会发生冲突。Odoo通过视图的priority字段和模块加载顺序来决定谁“胜出”。priority值越高，优先级越高。

最佳实践：尽量避免直接竞争。如果必须修改同一节点，考虑通过更精确的xpath定位到不同子节点，或者在你的模块中创建一个更高优先级的视图。

<record id="view_partner_form_inherit_high_priority" model="ir.ui.view"> <field name="priority">20</field> <!-- 默认是16，更高的值后加载，会覆盖先加载的 --> ... 其余继承定义 ... </record>

5.4 模型继承中的@api.model与@api.model_create_multi

在重写create方法时，Odoo 13之后推荐使用@api.model_create_multi装饰器以支持批量创建，但内部逻辑要处理好。

@api.model_create_multi def create(self, vals_list): for vals in vals_list: # 你的预处理逻辑 if vals.get('name'): vals.setdefault('customer_rank', 'basic') # 务必调用super return super(ResPartner, self).create(vals_list)

5.5 视图继承的“核武器”：直接替换整个视图

在极少数情况下，原有视图结构过于复杂或不适合你的需求，你可以选择不继承，而是直接定义一个新的视图，并让菜单动作指向它。这相当于放弃了继承的优雅，换来了完全的控制权。不到万不得已，不要用这招。

<!-- 1. 定义一个全新的视图 --> <record id="view_partner_form_custom" model="ir.ui.view"> <field name="name">res.partner.form.custom</field> <field name="model">res.partner</field> <field name="arch" type="xml"> <form> <!-- 完全自定义的布局 --> </form> </field> </record> <!-- 2. 修改或创建一个动作，使用这个新视图 --> <record id="action_partner_custom" model="ir.actions.act_window"> <field name="name">客户（自定义视图）</field> <field name="res_model">res.partner</field> <field name="view_mode">tree,form</field> <field name="view_id" ref="view_partner_form_custom"/> <!-- 指定默认表单视图 --> ... </record>

Odoo的继承机制，是其作为强大ERP框架的灵活性所在。它迫使开发者以一种可维护、可升级的方式进行定制。核心思想永远是：通过创建新的、独立的模块来扩展，而非修改原有模块。从模型到视图，这条原则一以贯之。刚开始接触xpath和继承语法可能会觉得繁琐，但一旦掌握，你会发现它是应对千变万化业务需求的瑞士军刀。记住，多利用开发者工具查看视图结构，多查看Odoo标准模块的源码作为参考，这是最快的学习路径。