第二章 Odoo开发之模块构建实战--从零到一打造一个图书管理应用（流程详解）

1. 从零搭建图书管理模块骨架

第一次接触Odoo模块开发时，我完全被各种配置文件搞晕了。后来发现其实只要掌握几个核心文件，就能快速搭建起一个可运行的模块。让我们以图书管理系统为例，从最基础的模块创建开始。

首先需要确保开发环境已经配置好。我习惯在项目根目录下创建独立的模块文件夹，比如/odoo-dev/my-modules/。这个路径需要添加到Odoo配置文件的addons_path中，否则系统会找不到你的模块。记得每次修改配置文件后都要重启Odoo服务。

创建模块最快捷的方式是使用scaffold命令：

bash复制./odoo-bin scaffold library_app /odoo-dev/my-modules/

这个命令会自动生成模块的基础结构，其中最关键的是两个文件：

• __manifest__.py：模块的身份证，包含名称、版本、依赖等元信息
• __init__.py：Python包的初始化文件

我建议第一次创建时先保持默认结构，等熟悉后再做调整。一个常见的坑是忘记在__init__.py中导入子模块，导致模型无法注册。我的习惯是在每个子目录（如models、views）都放一个__init__.py，形成清晰的导入链。

2. 定义图书数据模型

模型是Odoo应用的核心，相当于数据库的表结构。在图书管理系统中，我们至少需要定义Book模型。在models/library_book.py中：

python复制from odoo import fields, models

class LibraryBook(models.Model):
    _name = 'library.book'
    _description = '图书信息'
    
    name = fields.Char('书名', required=True)
    isbn = fields.Char('ISBN')
    author = fields.Char('作者')
    date_published = fields.Date('出版日期')
    cover_image = fields.Binary('封面图片')
    active = fields.Boolean('