如何使用WSL开发odoo

发布时间：2021-09-10 14:20:41 作者：小新
来源：亿速云阅读：254

# 如何使用WSL开发Odoo

## 目录
1. [WSL环境搭建](#wsl环境搭建)
   - [启用WSL功能](#启用wsl功能)
   - [安装Linux发行版](#安装linux发行版)
   - [系统初始化配置](#系统初始化配置)
2. [开发环境准备](#开发环境准备)
   - [安装必要工具链](#安装必要工具链)
   - [Python环境配置](#python环境配置)
   - [PostgreSQL数据库安装](#postgresql数据库安装)
3. [Odoo源码获取与配置](#odoo源码获取与配置)
   - [源码获取方式](#源码获取方式)
   - [目录结构解析](#目录结构解析)
   - [配置文件详解](#配置文件详解)
4. [开发工作流实践](#开发工作流实践)
   - [模块开发流程](#模块开发流程)
   - [调试技巧](#调试技巧)
   - [测试与部署](#测试与部署)
5. [常见问题解决方案](#常见问题解决方案)
   - [WSL特有问题](#wsl特有问题)
   - [Odoo常见错误](#odoo常见错误)
6. [性能优化建议](#性能优化建议)
7. [总结](#总结)

## WSL环境搭建

### 启用WSL功能

Windows Subsystem for Linux（WSL）是微软提供的兼容层，允许在Windows上原生运行Linux二进制文件。以下是启用步骤：

1. 以管理员身份打开PowerShell
```powershell
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启计算机后设置WSL2为默认版本：

wsl --set-default-version 2

安装Linux发行版

打开Microsoft Store，搜索并安装Ubuntu 20.04 LTS
安装完成后从开始菜单启动，等待初始化完成
设置用户名和密码（建议与Windows账户不同）

系统初始化配置

# 更新软件包列表
sudo apt update && sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl wget git gnupg2

# 配置SSH（可选）
sudo apt install -y openssh-server
sudo service ssh start

开发环境准备

安装必要工具链

# 安装编译依赖
sudo apt install -y build-essential libxslt-dev libzip-dev libldap2-dev libsasl2-dev

# 安装前端工具
sudo apt install -y npm
sudo npm install -g less
sudo npm install -g rtlcss

Python环境配置

推荐使用pyenv管理多版本Python：

# 安装pyenv
curl https://pyenv.run | bash

# 添加环境变量到.bashrc
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc

# 安装Python 3.8（Odoo 14/15推荐版本）
pyenv install 3.8.12
pyenv global 3.8.12

# 验证安装
python --version
pip install --upgrade pip

PostgreSQL数据库安装

# 安装PostgreSQL
sudo apt install -y postgresql postgresql-client

# 创建数据库用户
sudo -u postgres createuser -s $USER
createdb $USER

# 验证连接
psql -d postgres

Odoo源码获取与配置

源码获取方式

方式一：官方Git仓库

mkdir ~/odoo-dev
cd ~/odoo-dev
git clone https://github.com/odoo/odoo.git -b 15.0 --depth=1

方式二：企业版（需订阅）

git clone https://your_account@github.com/odoo/enterprise.git -b 15.0

目录结构解析

odoo/
├── addons/          # 官方核心模块
├── odoo/            # 框架核心代码
├── odoo-bin         # 主执行文件
├── requirements.txt # Python依赖
└── setup/           # 安装相关文件

配置文件详解

创建配置文件~/odoo-dev/odoo.conf：

[options]
; 基础配置
admin_passwd = admin
db_host = localhost
db_port = 5432
db_user = your_wsl_username
db_password = False

; 路径配置
addons_path = /home/your_user/odoo-dev/odoo/addons,/home/your_user/odoo-dev/custom_addons

; 开发配置
dev_mode = True
log_level = debug

开发工作流实践

模块开发流程

mkdir -p ~/odoo-dev/custom_addons

生成模块骨架

cd ~/odoo-dev/custom_addons
python ../odoo/odoo-bin scaffold my_module .

典型模块结构：

my_module/
├── __init__.py
├── __manifest__.py
├── controllers/
├── demo/
├── models/
├── security/
├── static/
└── views/

调试技巧

方法一：使用PDB

import pdb; pdb.set_trace()

方法二：VSCode配置

安装Python扩展
创建.vscode/launch.json：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Odoo Debug",
            "type": "python",
            "request": "launch",
            "program": "${workspaceFolder}/odoo-bin",
            "args": ["-c", "/path/to/odoo.conf"],
            "console": "integratedTerminal"
        }
    ]
}

测试与部署

运行单元测试

python odoo-bin -c odoo.conf --test-enable --stop-after-init -d test_db -i my_module

生产环境部署建议

使用专门的部署用户
配置合适的workers数量：

[options]
workers = 4
max_cron_threads = 1

常见问题解决方案

WSL特有问题

问题1：DB连接失败

# 解决方案：确保PostgreSQL监听所有地址
sudo nano /etc/postgresql/12/main/postgresql.conf
# 修改为：
listen_addresses = '*'

问题2：性能缓慢

# 将项目文件存储在WSL文件系统内（非/mnt/c/）

Odoo常见错误

错误1：缺少依赖

# 查看完整错误日志，安装对应依赖
sudo apt install -y python3-dev libxml2-dev libxslt1-dev

错误2：端口冲突

# 检查并修改配置文件中的http_port
netstat -tulnp | grep LISTEN

性能优化建议

文件系统优化：
- 避免在Windows目录（/mnt/c/）下运行Odoo
- 考虑使用wsl.conf优化挂载选项
数据库优化：

ALTER SYSTEM SET shared_buffers = '256MB';
ALTER SYSTEM SET effective_cache_size = '768MB';

开发模式配置：

[options]
dev_mode = True
; 禁用不需要的功能
list_db = False

总结

通过WSL开发Odoo可以兼顾Windows的易用性和Linux的开发环境优势。本文详细介绍了从环境搭建到模块开发的完整流程，以及常见问题的解决方案。随着WSL2的性能不断提升，这已成为Odoo开发的理想选择之一。

后续学习建议： 1. 深入学习Odoo ORM框架 2. 研究Odoo前端QWeb模板系统 3. 了解Odoo的扩展机制和钩子函数

注意：本文基于Odoo 15和WSL2编写，其他版本可能需要调整部分配置 “`

（注：实际字数为约3000字，完整4400字版本需要扩展每个章节的实践案例和更详细的技术解析，受限于回答长度限制，此处提供核心框架和关键内容）