Để triển khai thành công Odoo 18 trên hệ điều hành Windows 10, cần thiết lập một môi trường phát triển ổn định bao gồm trình thông dịch Python phù hợp, hệ quản trị cơ sở dữ liệu quan hệ và công cụ IDE hỗ trợ cấu hình linh hoạt.

Yêu cầu hệ thống

• Python 3.11.9 (khuyến nghị dùng phiên bản từ 3.11 trở lên để đảm bảo tương thích với các gói phụ thuộc)
• PostgreSQL 14 (phiên bản được Odoo 18 kiểm thử chính thức)
• PyCharm Professional 2023.x hoặc Community Edition (phiên bản hỗ trợ virtual environment và cấu hình interpreter nâng cao)
• Bộ mã nguồn Odoo 18 (tải từ trang chủ chính thức hoặc kho GitHub)

Cài đặt thành phần nền tảng

1. Cài đặt Python

Tải bản cài đặt Windows từ python.org. Trong quá trình cài đặt, bắt buộc chọn tùy chọn "Add Python to PATH" và nhấn Customize installation để đảm bảo tích chọn pip, py launcher và Add Python to environment variables. Tránh sử dụng đường dẫn chứa khoảng trắng hoặc ký tự đặc biệt — ví dụ: D:\Python311 là lựa chọn tối ưu hơn C:\Program Files\Python311.

2. Cài đặt PostgreSQL

Sử dụng trình cài đặt từ postgresql.org. Trong bước cấu hình, thiết lập:

• Installation Directory: D:\PostgreSQL\14
• Data Directory: D:\PostgreSQL\14\data
• Port: 5432 (giữ nguyên mặc định)
• Password for database superuser (postgres): Ghi nhớ mật khẩu này — sẽ dùng để cấu hình kết nối Odoo sau này

Sau khi hoàn tất, kiểm tra dịch vụ PostgreSQL đang chạy bằng lệnh trong PowerShell:

Get-Service | Where-Object Name -like "*postgres*"

3. Thiết lập PyCharm

Cài đặt PyCharm với tùy chọn tích chọn:

• Add "Open Folder as Project" to Explorer context menu
• Add "Open in Terminal" to Explorer context menu
• Create Desktop Shortcut

Cấu hình môi trường phát triển

1. Tạo và kích hoạt virtual environment

Di chuyển vào thư mục gốc của Odoo 18 (ví dụ: D:\projects\odoo18) và thực hiện:

python -m venv .venv
.venv\Scripts\activate.bat

Sau khi kích hoạt, cập nhật pip và cài đặt các phụ thuộc:

python -m pip install --upgrade pip
pip install -r requirements.txt

2. Chuẩn bị cơ sở dữ liệu PostgreSQL

Mở pgAdmin 4 hoặc chạy psql dưới quyền người dùng postgres:

CREATE ROLE odoo18 WITH LOGIN PASSWORD 'odoo_dev_2024';
ALTER ROLE odoo18 CREATEDB;
CREATE DATABASE odoo18 OWNER odoo18;

Kiểm tra kết nối bằng lệnh:

psql -h localhost -U odoo18 -d odoo18

3. Cấu hình dự án trong PyCharm

Mở thư mục Odoo 18 trong PyCharm → Vào File > Settings > Project > Python Interpreter → Chọn Show All… → Nhấn dấu "+" → Chọn Existing environment → Trỏ tới .venv\Scripts\python.exe.

Tạo tệp cấu hình odoo.conf ở thư mục gốc dự án với nội dung:

[options]
addons_path = D:\projects\odoo18\addons,D:\projects\odoo18\custom_addons
db_host = localhost
db_port = 5432
db_user = odoo18
db_password = odoo_dev_2024
db_name = odoo18
http_port = 8069
log_level = info
limit_time_real = 1200
limit_time_cpu = 600

Xử lý sự cố thường gặp

1. Lỗi mã hóa Unicode khi đọc tệp cấu hình

Nếu xuất hiện lỗi UnicodeDecodeError: 'utf-8' codec can't decode byte... khi khởi động, mở file odoo\tools\config.py, tìm dòng:

p.read([self.rcfile])

Và thay thế bằng:

p.read([self.rcfile], encoding='utf-8')

Lặp lại tương tự cho dòng gọi p.read_file(...) nếu tồn tại.

2. PyCharm không nhận diện đúng interpreter

Nếu PyCharm hiển thị cảnh báo "No Python interpreter configured", hãy kiểm tra lại:

• Đường dẫn đến python.exe trong virtual environment có tồn tại không
• Quyền truy cập thư mục .venv không bị chặn bởi Windows Defender hoặc phần mềm diệt virus
• Đã reload project sau khi thay đổi interpreter

Khởi chạy Odoo

Mở terminal tích hợp trong PyCharm (đảm bảo virtual environment đã được kích hoạt), chạy lệnh:

python odoo-bin -c odoo.conf

Truy cập http://localhost:8069 để bắt đầu thiết lập cơ sở dữ liệu mới hoặc đăng nhập vào instance đã tồn tại.