Odoo 9 Windows 安装教程：从零搭建到成功启动

目标关键词：Odoo 9 Windows 安装

Odoo 9 是一套比较经典的开源 ERP 系统，适合做进销存、销售、采购、库存、CRM、财务等业务管理。很多人第一次接触 Odoo 时，都会先想在 Windows 上本地搭一个测试环境，方便学习、演示或者做开发调试。
不过 Odoo 9 年代比较早，Windows 上安装时会比现在的新版本更容易遇到依赖缺失、Python 版本不匹配、PostgreSQL 配置问题、编译工具缺失等情况。只要按正确步骤来，还是可以顺利跑起来的。

下面这篇文章会按照问题分析 → 解决方案 → 注意事项的结构，手把手讲清楚 Odoo 9 Windows 安装 的完整流程，尽量让小白也能照着做。

---

一、问题分析：为什么 Odoo 9 在 Windows 上安装容易出问题

Odoo 9 不是单独一个程序，它运行时依赖很多组件，主要包括：

1. Python 2.7
2. PostgreSQL 数据库
3. wkhtmltopdf（用于打印 PDF 报表）
4. 一些 Python 扩展库
5. Windows 环境变量和编译工具

最常见的安装失败原因一般有这几个：

• Python 版本装错了
  Odoo 9 主要配套的是 Python 2.7，如果装了 Python 3.x，很多模块会直接报错。

• PostgreSQL 没配置好
  数据库账号、密码、端口、服务启动状态不正常，Odoo 就连不上数据库。

• 缺少 Visual C++ 编译环境
  一些 Python 模块需要编译，Windows 没装开发组件时会安装失败。

• wkhtmltopdf 版本不兼容
  这个工具版本太新或太旧，都可能导致 PDF 预览、打印异常。

• 路径或权限问题
  比如把 Odoo 解压到中文路径、桌面路径、或者权限受限目录，启动时容易出各种奇怪错误。

所以，Windows 上装 Odoo 9 的核心思路就是：
先把 Python、数据库、依赖环境准备好，再启动 Odoo。

---

二、解决方案：Odoo 9 Windows 安装完整步骤

下面按最稳妥的方式来讲，建议全程使用 64 位 Windows 7/10/11，并尽量使用英文路径安装。

---

1. 准备安装文件

你需要先准备这些东西：

• Python 2.7.x
• PostgreSQL
• Odoo 9 源码或安装包
• wkhtmltopdf
• pip（Python 包管理工具，Python 2.7 一般会自带，但建议确认）
• Microsoft Visual C++ 运行库 / 编译工具

建议把所有文件统一放到一个简单目录里，比如：

D:\Odoo9\

目录尽量不要有中文，不要放在“桌面”“下载”这类路径里，避免权限和编码问题。

---

2. 安装 Python 2.7

安装步骤

1. 下载 Python 2.7.x 64 位安装包
2. 双击安装
3. 勾选：
   • Add python.exe to Path（如果安装器有这个选项，直接勾上）
4. 安装到默认路径或简单路径，例如：

   C:\Python27

验证安装

安装完成后，按 Win + R，输入：

cmd

打开命令提示符后输入：

python --version

正常应显示类似：

Python 2.7.18

如果提示不是内部或外部命令，说明环境变量没配好，需要手动配置。

---

3. 配置 Python 环境变量

如果 python --version 没反应，就手动加环境变量。

操作方法

1. 右键“此电脑” → 属性
2. 点击 高级系统设置
3. 进入 环境变量
4. 在“系统变量”里找到 Path
5. 点击编辑，加入 Python 安装路径，例如：

C:\Python27\
C:\Python27\Scripts\

6. 保存后重新打开命令行，再执行：

python --version
pip --version

---

4. 安装 PostgreSQL 数据库

Odoo 的数据都放在 PostgreSQL 里，所以这个步骤非常关键。

安装建议

推荐安装 PostgreSQL 9.4 或兼容 Odoo 9 的版本。
安装时记住以下信息：

• 数据库端口：默认 5432
• 超级用户：一般是 postgres
• 安装密码：自己设置一个，后面 Odoo 要用

安装步骤

1. 双击 PostgreSQL 安装包
2. 一路下一步
3. 设置数据库超级用户密码
4. 保持端口默认 5432
5. 完成安装

验证数据库服务是否启动

按 Win + R 输入：

services.msc

找到 PostgreSQL 服务，看状态是否为“正在运行”。

如果没运行，手动启动。

---

5. 安装 wkhtmltopdf

这个工具主要用于把 Odoo 报表导出成 PDF。

安装注意

Odoo 9 对 wkhtmltopdf 版本有一定要求。常见可用版本是 0.12.1 或兼容版本。
如果版本太高，可能会出现中文乱码、页面空白、PDF 导出失败等问题。

安装方法

1. 下载兼容版本
2. 安装到英文路径，例如：

C:\wkhtmltopdf\

3. 把它的 bin 目录加入环境变量，例如：

C:\wkhtmltopdf\bin

验证

命令行输入：

wkhtmltopdf --version

能显示版本号就说明正常。

---

6. 安装必要的 Python 依赖

Odoo 9 需要很多 Python 库，比如：

• lxml
• psycopg2
• babel
• decorator
• docutils
• python-dateutil
• requests
• werkzeug
• pytz
• Jinja2

推荐方式

先升级 pip：

python -m pip install --upgrade pip

然后安装依赖。
如果你是拿 Odoo 9 源码，通常源码目录里会有 requirements.txt，可以直接执行：

pip install -r requirements.txt

常见问题

在 Windows 上，psycopg2、lxml 这类模块容易安装失败。
如果直接装失败，可以尝试：

pip install psycopg2-binary

不过对老版本 Odoo 来说，最稳妥的是配好对应版本依赖，必要时手动下载 .whl 文件安装。

---

7. 获取 Odoo 9 程序文件

Odoo 9 可以有两种方式获取：

• 源码包
• Windows 可运行版本

如果你是学习或开发，建议直接用源码方式，方便调试。

解压建议

假设你把 Odoo 放到：

D:\Odoo9\odoo-9.0\

目录结构大致会包含：

• odoo.py
• addons
• openerp
• requirements.txt

如果是官方源码，入口文件可能是 odoo.py。

---

8. 配置 Odoo 9 的配置文件

Odoo 启动时通常需要一个 .conf 配置文件。

例如新建：

D:\Odoo9\odoo.conf

内容可以写成这样：

[options]
addons_path = D:\Odoo9\odoo-9.0\addons,D:\Odoo9\odoo-9.0\openerp\addons
db_host = localhost
db_port = 5432
db_user = postgres
db_password = 你的数据库密码
logfile = D:\Odoo9\odoo.log
xmlrpc_port = 8069

配置说明

• addons_path：插件目录，按你的源码结构填写
• db_host：数据库地址，本机就写 localhost
• db_port：PostgreSQL 端口，默认 5432
• db_user：数据库用户名，一般是 postgres
• db_password：数据库密码
• xmlrpc_port：Odoo 默认网页端口，通常是 8069

---

9. 启动 Odoo 9

打开命令提示符，切换到 Odoo 目录：

cd /d D:\Odoo9\odoo-9.0

然后运行：

python odoo.py -c D:\Odoo9\odoo.conf

如果你的入口文件不是 odoo.py，而是其他脚本，就按实际文件名替换。

正常启动后

启动成功后，命令行里会看到类似日志信息，然后在浏览器打开：

http://127.0.0.1:8069

这时如果页面出来了，说明安装成功。

---

10. 第一次进入 Odoo 初始化数据库

第一次打开 Odoo 页面时，会让你创建一个数据库。

你需要填写：

• 数据库名称
• 管理员邮箱
• 管理员密码
• 语言
• 演示数据是否加载

建议

• 新手可以先勾选演示数据，方便体验
• 数据库名称不要用中文
• 密码要记住，后面登录要用

创建完成后，就可以进入 Odoo 后台界面了。

---

三、常见报错与解决方法

下面是 Odoo 9 Windows 安装里最常见的问题，基本遇到一个排一个。

---

1. 提示 Python 版本不对

现象

运行时提示语法错误、模块不兼容、导入失败。

原因

装成了 Python 3.x。

解决方法

卸载 Python 3，重新安装 Python 2.7，并确保命令行里执行的是 Python 2.7。

---

2. 提示找不到 psycopg2

现象

报错类似：

No module named psycopg2

解决方法

执行：

pip install psycopg2-binary

如果不行，再检查是否安装了匹配的 Python 2.7 版本包。

---

3. 提示数据库连接失败

现象

报错类似：

could not connect to server

解决方法

按顺序排查：

1. PostgreSQL 服务是否启动
2. 用户名密码是否正确
3. 端口是不是 5432
4. db_host 是否写成 localhost
5. 防火墙是否拦截了本地连接

---

4. 页面打不开，显示无法访问

现象

浏览器打不开 http://127.0.0.1:8069

解决方法

检查这几个点：

• Odoo 程序是否真的启动成功
• 8069 端口有没有被占用
• 配置文件里 xmlrpc_port 是否正确
• 防火墙是否拦截

可以用命令查看端口占用：

netstat -ano | findstr 8069

如果被别的程序占了，换个端口，比如：

xmlrpc_port = 8070

然后访问：

http://127.0.0.1:8070

---

5. PDF 导出乱码或失败

现象

打印报表时空白、报错、中文乱码。

解决方法

通常是 wkhtmltopdf 版本不对。

建议：

• 换成 Odoo 9 兼容版本
• 确认 wkhtmltopdf.exe 路径加入环境变量
• 路径不要带中文

---

6. 启动特别慢

现象

点开后半天没反应。

解决方法

• 第一次初始化数据库本来就会慢
• 关闭杀毒软件临时测试
• 把 Odoo 放到 SSD 里
• 确认系统内存至少 4GB，建议 8GB

---

四、提高成功率的实用建议

1. 尽量不要把 Odoo 装在中文路径

比如这些路径尽量避免：

D:\我的软件\odoo9\
C:\Users\用户名\Desktop\odoo\

推荐：

D:\Odoo9\

---

2. 统一使用管理员权限运行

安装 PostgreSQL、配置环境变量、启动命令行时，尽量右键选择：

• 以管理员身份运行

这样能减少权限问题。

---

3. 先确认数据库正常，再启动 Odoo

很多人安装失败，其实不是 Odoo 的问题，而是 PostgreSQL 没装好。

---

4. 不要随便混装 Python 包

Odoo 9 依赖的是旧版本生态，别直接把新教程里的 Python 3 包拿来混装，不然很容易冲突。

---

5. 如果只是学习，虚拟机反而更稳

虽然本文讲的是 Odoo 9 Windows 安装，但如果你本机环境复杂，建议在 VMware 里单独装一个纯净 Windows 或 Linux，再部署 Odoo，会更稳定。

---

五、推荐的最稳安装顺序

如果你怕漏步骤，可以直接按这个顺序执行：

1. 安装 Python 2.7
2. 配置 Python 环境变量
3. 安装 PostgreSQL
4. 设置数据库密码并确认服务启动
5. 安装 wkhtmltopdf
6. 配置 wkhtmltopdf 环境变量
7. 安装 Odoo 9 源码
8. 安装 Python 依赖
9. 配置 odoo.conf
10. 运行 python odoo.py -c 配置文件路径
11. 浏览器打开 127.0.0.1:8069
12. 创建数据库并登录

---

六、总结

Odoo 9 在 Windows 上安装的关键，不是单纯把程序解压出来，而是要把 Python 2.7、PostgreSQL、wkhtmltopdf、依赖库、环境变量 一起配齐。
只要版本别装错、路径别乱放、数据库别配错，Odoo 9 一般都能顺利启动。

如果你是第一次接触，最容易成功的思路就是：

• 先装 Python 2.7
• 再装 PostgreSQL
• 最后配 Odoo 和依赖
• 全程用英文路径
• 启动前先检查端口和数据库服务

这样基本就能把 Odoo 9 Windows 安装 跑通。