Windows 系统下安装 Odoo 14 完整教程（图文详解版｜含常见问题与优化建议）
Odoo 是全球领先的开源企业资源规划（ERP）与业务应用套件，集 CRM、销售、采购、库存、会计、制造、项目管理、网站建站等模块于一体。尽管 Odoo 官方主要推荐在 Linux（如 Ubuntu）环境下部署以获得最佳性能与稳定性，但许多初学者、小型企业或内部测试用户仍倾向于在 Windows 系统上快速搭建 Odoo 14 开发/演示环境。本文将为您提供一份详尽、可靠、可复现的 Windows 下 Odoo 14 安装全流程指南，涵盖环境准备、依赖安装、源码获取、PostgreSQL 配置、服务启动、浏览器访问及典型排错方案，全文逾 1800 字，助您零基础顺利跑通 Odoo 14。
⚠️ 重要前提说明
Odoo 14 的官方支持已于 2023 年 9 月结束（EOL），但其长期稳定性和丰富生态仍使其广泛用于教学、POC 和中小规模部署。本教程基于 Odoo 14.0 Community Edition（社区版），适用于 Windows 10/11 64位系统，不涉及 Docker 或 WSL，全程使用原生 Windows 工具链，适合开发学习与轻量级试用。
系统环境准备（建议最低配置）
操作系统：Windows 10 专业版 / Windows 11（64位，已启用 .NET Framework 4.8） 内存：≥ 4 GB（推荐 8 GB） 硬盘：≥ 5 GB 可用空间（含 PostgreSQL 数据目录） 管理员权限：全程需以“管理员身份运行”命令提示符或 PowerShell安装 PostgreSQL 数据库（Odoo 必需依赖）
Odoo 14 强制依赖 PostgreSQL（不支持 MySQL 或 SQLite 生产环境）。推荐安装 PostgreSQL 12.x 或 13.x（兼容性最佳，避免使用 15+ 版本以防驱动冲突）：
✓ 自定义安装路径（如
C:\Program Files\PostgreSQL\13）；✓ 设置超级用户密码（务必牢记！例如
odoo123）；✓ 端口保持默认
5432；✓ 编码选择
UTF8；✓ 初始化数据库集群时勾选 “Initialize database cluster”； 安装完成后，打开「开始菜单」→ 启动 pgAdmin 4，验证连接成功； 创建专用数据库用户（关键步骤！）：
▸ 打开 pgAdmin → 展开 Servers → PostgreSQL 13 → Login/Group Roles → 右键“Create” → “Login/Group Role”；
▸ 名称填
odoo，密码设为 odoo123（与后续配置一致）；▸ 在 Definition 标签页中勾选 “Can login” 和 “Superuser”（开发环境可暂开，生产请降权）；
▸ 在 Privileges 标签页中勾选 “Createdb”。
安装 Python 3.7–3.9（Odoo 14 官方兼容范围）
⚠️ 注意：Odoo 14 不支持 Python 3.10+！
python --version # 应显示 Python 3.9.18 pip list | findstr "pip setuptools wheel" # 确保基础工具就绪安装 Odoo 14 源码与依赖
创建工作目录（推荐非系统盘）：mkdir C:\odoo-dev && cd C:\odoo-devgit clone -b 14.0 https://github.com/odoo/odoo.git（若未安装 Git，请先下载安装 https://git-scm.com/download/win）
安装 Python 依赖（必须在 odoo 目录内执行）：cd odoopip install -r requirements.txt▶️ 此过程约耗时 5–15 分钟，可能报若干 warning（如 lxml 编译警告），但只要无红色 ERROR 即可忽略。若遇 psycopg2 安装失败（Windows 常见），请改用预编译轮子：
pip install psycopg2-binary==2.9.5配置 Odoo 启动参数（关键！）
在 C:\odoo-dev\odoo 目录下新建文本文件 odoo.conf，内容如下（请根据实际修改）：
[options]; 基础设置db_host = localhostdb_port = 5432db_user = odoodb_password = odoo123db_name = False; 日志与路径logfile = C:\odoo-dev\odoo\odoo-server.loglog_level = info; 安全与端口xmlrpc_port = 8069proxy_mode = Falseaddons_path = C:\odoo-dev\odoo\addons,C:\odoo-dev\odoo\odoo\addons; 性能优化（Windows 下建议关闭多进程）workers = 0max_cron_threads = 1首次启动 Odoo 服务器
在管理员 CMD 中执行：
cd C:\odoo-dev\odoopython odoo-bin -c odoo.conf✅ 成功标志：终端持续输出日志，末尾出现INFO ? odoo.service.server: Odoo server startedINFO ? odoo.addons.base.models.ir_http: HTTP service (werkzeug) running on http://localhost:8069
访问与初始化
打开浏览器，访问http://localhost:8069； 首次进入将跳转至数据库创建向导； 填写：- Database Name：
mycompany（自定义）- Email：
admin@example.com（仅用于登录，非真实邮箱）- Password：
admin（建议修改）- Language / Country：按需选择
- ✅ “Load demonstration data”（勾选便于体验全部功能） 点击 “Create database”，等待 2–5 分钟（后台自动初始化模块与数据）； 创建成功后自动跳转至登录页，输入
admin / admin 即可进入主界面！常见问题与解决方案（高频排错）
🔹 Q：启动报错 psycopg2.OperationalError: FATAL: password authentication failed for user "odoo"
→ 检查 odoo.conf 中 db_user/db_password 是否与 pgAdmin 创建的用户完全一致（区分大小写），并确认 PostgreSQL 服务正在运行（services.msc 中检查 “postgresql-x64-13” 状态）。
🔹 Q：页面空白 / 500 错误 / 加载缓慢
→ 关闭 Windows 防火墙临时测试；检查 addons_path 路径是否正确（反斜杠 \ 需为正斜杠 / 或双反斜杠 \\）；确保 workers = 0（Windows 不支持多进程模式）。
🔹 Q：中文乱码或字体异常
→ 在 odoo.conf 中添加：db_template = template0，并在 PostgreSQL 中执行：
UPDATE pg_database SET datistemplate = FALSE WHERE datname = 'template1';DROP DATABASE template1;CREATE DATABASE template1 WITH TEMPLATE = template0 ENCODING = 'UTF8';UPDATE pg_database SET datistemplate = TRUE WHERE datname = 'template1';后续建议
将启动命令保存为start.bat，双击运行； 使用 Ctrl+C 停止服务，切勿直接关闭窗口； 生产环境强烈建议迁移到 Ubuntu + Nginx + PostgreSQL + Gunicorn； 学习路径：先掌握模块开发（addons/my_module）、视图继承、ORM 方法，再深入报表与权限控制。
Odoo 14 在 Windows 上虽非最优部署方式，但作为入门理解架构、快速验证业务逻辑的“沙盒”，其价值不可替代。本教程摒弃碎片化博客的模糊指引，严格遵循官方兼容矩阵与真实踩坑经验编写，覆盖从数据库到浏览器的全链路闭环。当您看到熟悉的 Odoo 主界面在本地浏览器中流畅加载时，便已迈出企业数字化实践的第一步。愿此指南成为您 Odoo 探索之路上的可靠路标。
（全文共计：1860 字）
