本章介绍如何在不同操作系统上搭建 Odoo 开发环境。

注意

在开始之前,请确保你的系统已安装 Git 和 Python 3.10+。

系统要求

根据你的操作系统选择对应的安装方式:

sudo apt update
sudo apt install git python3-dev python3-pip python3-venv \
  build-essential libpq-dev libxml2-dev libxslt1-dev \
  libldap2-dev libsasl2-dev libjpeg-dev libssl-dev
brew install python@3.12 postgresql@16 node libffi libxml2 libxslt

建议使用 WSL2 + Ubuntu 22.04,然后参考 Ubuntu 的安装步骤。

安装 PostgreSQL

sudo apt install postgresql
sudo -u postgres createuser -s $(whoami)
brew services start postgresql@16
createuser -s $(whoami)

配置 odoo.conf

创建配置文件 odoo.conf

[options]
addons_path = /path/to/odoo/addons,/path/to/custom-addons
db_host = localhost
db_port = 5432
db_user = odoo
db_password = odoo
admin_passwd = admin
http_port = 8069
警告

请勿在生产环境中使用默认密码。admin_passwd 用于保护数据库管理界面,请务必设置强密码。

IDE 配置

提示

推荐使用 VS Code,安装 Python、Pylance、XML Tools 和 Odoo Snippets 扩展可大幅提升开发效率。

配置 settings.json

{
  "python.defaultInterpreterPath": "${workspaceFolder}/venv/bin/python",
  "python.analysis.extraPaths": ["${workspaceFolder}"]
}

验证安装

./odoo-bin -c odoo.conf --stop-after-init

若无错误输出,则环境搭建成功。

重要

首次启动前请确认 PostgreSQL 服务已运行,并且数据库用户已创建。可通过 psql -l 验证连接。

危险

绝对不要将 odoo.conf 中的密码提交到 Git 仓库。请将配置文件添加到 .gitignore