---
title: Odoo 9 模块安装与自定义插件目录配置
description: 面向企业 IT 运维，说明 Odoo 9 安装第三方或自研模块的通用流程：准备独立插件目录、修改 addons_path、重启服务、更新模块列表并安装。含备份与回退提醒、验证方法与常见问题，参数均用占位符表示。
url: "https://www.lanever.com/docs/odoo-9-%e6%a8%a1%e5%9d%97%e5%ae%89%e8%a3%85%e4%b8%8e%e8%87%aa%e5%ae%9a%e4%b9%89%e6%8f%92%e4%bb%b6%e7%9b%ae%e5%bd%95%e9%85%8d%e7%bd%ae/"
updated: "2026-10-12"
category: Odoo
---

# Odoo 9 模块安装与自定义插件目录配置

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How can I install apps/modules in odoo v9](http://stackoverflow.com/questions/37405573/how-can-i-install-apps-modules-in-odoo-v9)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

需要在 Odoo 9 环境中安装官方应用、第三方模块或自研模块时，通常有两种做法：把模块放入默认插件目录，或建立独立的自定义插件目录并在配置中登记。后者便于升级与备份，推荐生产环境采用。本文描述通用操作路径，具体路径、服务名与配置文件名以实际部署为准，不确定处请查阅对应版本官方文档。

## 准备与风险

- 确认 Odoo 版本与模块声明的兼容版本一致，版本不匹配可能导致加载失败。
- 准备测试环境，先在测试库验证模块安装与升级，再操作生产库。
- 备份数据库与文件存储，并记录当前配置文件的完整内容。
- 确认模块来源可信，第三方模块可能包含任意代码，安装即等于在该服务账号权限下执行。
- 确认磁盘空间、文件属主与权限，服务账号需对插件目录有读取权限。

> 涉及重启服务、修改配置、安装模块等操作前，务必完成数据库备份并保留可回退的配置副本。生产环境操作建议安排在维护窗口。

## 处理步骤

### 1. 建立自定义插件目录

在 Odoo 安装目录旁建立独立目录，与默认插件目录并列，例如：

```
[Odoo安装目录]/addons
[Odoo安装目录]/custom_addons
```

将模块解压或放置到 `custom_addons` 下，每个模块一个子目录，目录名与模块技术名一致。

### 2. 登记插件路径

编辑服务配置文件，在 `addons_path` 中追加新目录，多个路径用英文逗号分隔，顺序影响同名模块的加载优先级：

```
addons_path = [Odoo安装目录]/custom_addons,[Odoo安装目录]/addons
```

保存后重启 Odoo 服务，使配置生效。

### 3. 更新模块列表

以具备权限的账号登录，进入应用或模块管理界面，执行“更新模块列表”。该操作会重新扫描插件路径并刷新可用模块清单。

### 4. 安装模块

在模块列表中按技术名或显示名搜索目标模块，确认作者、版本与依赖后点击安装。安装过程会创建或修改数据库结构，耗时取决于模块规模。

### 5. 启用开发者相关选项

部分界面与调试功能需要开发者模式或技术特性权限。可在“关于”页面启用开发者模式，或在用户设置中为用户开启技术特性，然后刷新页面。该步骤仅影响界面可见性，不改变模块本身。

## 验证方法

- 模块列表中目标模块状态显示为已安装，且无报错提示。
- 查看服务日志，确认无导入错误、依赖缺失或权限异常。
- 打开模块提供的菜单或视图，执行一次基本业务操作，确认功能可用。
- 重启服务后再次确认模块仍正常加载，排除仅内存生效的情况。

## 回退建议

- 卸载模块前先备份数据库，卸载可能删除该模块创建的数据表与字段。
- 若仅配置有误，恢复原配置文件并重启服务即可。
- 若模块导致服务无法启动，可临时从 `addons_path` 移除该目录或移走模块目录，再重启排查。
- 数据库层面回退应使用备份恢复，不建议手工删改表结构。

## 常见问题

- 模块列表搜不到：检查目录名与模块技术名是否一致、`addons_path` 是否生效、服务是否已重启。
- 安装报依赖错误：确认依赖模块已安装且版本匹配。
- 升级后模块失效：核对模块声明的兼容版本，必要时联系模块提供方确认。
- 权限报错：检查插件目录属主与权限，确保服务账号可读。
