与 Odoo 19.0 官方开发者文档对照
主入口：Developer — Odoo 19.0 documentation
官方结构分为 Tutorials（教程）、How-to guides（操作指南）、Reference（参考手册） 三层；本教材章节与下表 交叉阅读 效果最好。
版本提示：链接均指向 19.0；若你使用 Odoo 19.2 等子版本文档，请在官网左上角切换版本后对照。
一、官方三大板块怎么用
| 板块 | 适合场景 | 入口 |
|---|---|---|
| Tutorials | 从零跟做、建立肌肉记忆 | Tutorials |
| How-to guides | 解决具体任务（多公司、报表、网站主题等） | How-to guides |
| Reference | 查 API、视图 XML、CLI、安全规则 | Reference |
推荐阅读顺序（新手）：
- Server framework 101（与本书第 1～13 章主线一致）
- Discover the web framework（与第 32～36 章呼应）
- 遇到具体 API 再下钻 Reference → Server framework / Web framework
二、教材章 ↔ 官方 Reference（后端）
| 教材文件（章） | 官方 Reference 主题 | 链接 |
|---|---|---|
| 02～04、ORM | ORM API（含 Models、Fields、Environment、装饰器） | ORM API |
| 迁移/版本 | ORM Changelog | ORM Changelog |
| 06、11 | Data Files（record、function、CSV、noupdate） | Data Files |
| 07、30 | Security（ACL、Record Rules、Field Access、Pitfalls） | Security in Odoo |
| 09 | Actions（act_window、server、client、report、cron） | Actions |
| 13、19 | QWeb Reports | QWeb Reports |
| 14 | Performance（Profiling、Good practices） | Performance |
| 29 | Testing Odoo（Python/JS、Query counts） | Testing Odoo |
| 36 | Web Controllers（Routing、Request、Response） | Web Controllers |
| 20 | Mixins（mail.thread、activity、website 等） | Mixins and Useful Classes |
| 01、27 | Module Manifests | Module Manifests |
| 44 | Upgrade scripts、Upgrade utils | Upgrades |
| 37 | External JSON-2 API | External JSON-2 API |
| 37 | External RPC API（含迁移说明） | External RPC API |
| 39 | Extract API | Extract API |
| 42、49、99-B | 本地/源码安装、CLI | Source install · Packaged installers · CLI |
| 46.6 | Standard modules（Accounting、Payment） | Standard modules |
| 47.1～47.2、45 | Multi-company、性能与索引思路 | Multi-company Guidelines · Performance |
| 47.3 | 库存追溯（用户文档为主） | Inventory（产品跟踪、批次/序列号） |
| 47.4～47.5 | ORM、context、批量实践 |
ORM API（Environment、Recordset、Performance good practices） |
| 41、48 | AI 产品功能与用户向说明 | AI（User Docs） |
| 48 | Web 控制器、JSON-RPC | Web Controllers |
三、教材章 ↔ 官方 Reference（前端与 UI）
| 教材文件（章） | 官方主题 | 链接 |
|---|---|---|
| 14、32 | Framework Overview、WebClient | Framework overview |
| 14、32 | Assets、bundles、lazy、ir.asset | Assets |
| 33 | Javascript Modules（@odoo-module） |
Javascript Modules |
| 32、35 | Owl components | Owl components |
| 32 | Registries | Registries |
| 32 | Services | Services |
| 32 | Hooks | Hooks |
| 32 | Patching code | Patching code |
| 33 | Error handling | Error handling |
| 34、32.7 | SCSS inheritance | SCSS inheritance |
| 34、99-D | UI icons | UI icons |
| 08、99-D | View records、View architectures（各视图类型） | View records · View architectures |
| 46.8 | Mobile JavaScript | Mobile JavaScript |
| 35、29 | JavaScript Unit Testing（HOOT 等） | JavaScript Unit Testing |
| 35 | Odoo Editor、Powerbox | Odoo Editor |
四、How-to guides 精选（按主题）
| 教材相关章 | 指南主题 | 链接 |
|---|---|---|
| 34、32 | Write lean easy-to-maintain CSS | Lean CSS |
| 35 | Customize a field / view type | Customize a field · Customize a view type |
| 26 | Create a client action | Create a client action |
| 36 | Standalone Owl application（独立页） | Standalone Owl application |
| 46.7 | Owl on portal/website、Website themes | Owl on portal and website · Website themes |
| 45、46.1 | Multi-company Guidelines | Multi-company Guidelines |
| 19 | Create customized reports | Create customized reports |
| 23 | Translating Modules | Translating Modules |
| 40 | Connect with a device | Connect with a device |
| 44 | Upgrade a customized database | Upgrade a customized database |
How-to 目录会随版本增减，以上以 How-to 总览 为准。
五、User Docs 中与「开发周边」相关的入口
实施与交付常要查 功能行为（非 API），可在 User Docs 总览 中按应用检索，例如：
- Studio（对应教材 46.3～46.4）
- Spreadsheet（46.5）
- Website / eCommerce（46.7）
- IoT（40 章）
- AI（User Docs）（与 41 章产品功能互补）
- Database management / Odoo.sh / Neutralized database（42、43 章）
六、Contributing 与编码规范
| 用途 | 链接 |
|---|---|
| 官方 Python / Git 约定 | Coding guidelines · Git guidelines |
| 文档贡献（RST） | Documentation contributing |
本书 第二十七章 可与上述 Coding guidelines 对照；团队若以 OCA 为准，可再叠加 OCA pylint-odoo / eslint 规则。
本文件随官方文档结构调整时，请批量检查链接是否 404 并更新路径。