你在 Odoo19 里放好了一个自定义模块，准备安装时却在「应用」列表里根本找不到它——这基本不是 Odoo 的 bug，而是模块没被正确”扫到”或”解锁”。下面按最容易踩坑的顺序排了一下。
1. 先点「更新应用列表」
把模块文件放进 addons 目录后，Odoo 不会实时刷新。进入应用 → 右上角「更新应用列表」（或开发者模式下菜单的 Update Apps List），等进度条走完再去搜你的模块名。很多人就是卡在这一步。2. 检查 manifest 的 depends
打开模块下的__manifest__.py，确认 depends 里写的依赖模块都存在且拼写正确。只要有一个依赖名写错或根本不存在，Odoo 会静默地把这个模块藏起来，前台完全看不到。
3. 确认 addons_path 包含你的目录
自定义模块必须放在odoo.conf 里 addons_path 列出的路径中（多个路径用逗号分隔）。路径没包含，Odoo 启动时根本扫描不到，自然就不显示。改完配置记得重启服务。
4. 看过滤条件有没有挡住
「应用」页默认只显示”可安装”的应用，而且常带着”已安装/未安装”之类的过滤。确认过滤条件没把你的模块筛掉，也可以直接在右上角搜索框里搜模块的技术名。5. 查日志定位真因
如果上面几项都正常，就看 Odoo 的运行日志里有没有ImportError、module not found 或者 Python 语法错误——多数”不显示”其实是模块导入失败被跳过了，日志里会给出确切的行号。
基本照着这几步走，多半能定位到问题。你在 fenij.com 上踩过哪种坑？留言说说，我接着写对应的排查文。
常见问题（FAQ）
Odoo 自定义模块装了但不显示怎么办？
先确认模块已真正安装（非仅上传）；检查 __manifest__.py 的 depends 是否都已安装；在应用列表勾选”可安装/隐藏”过滤器确认模块可见；清除缓存并重启服务；最后查看 server 日志里的报错定位原因。
Odoo 模块不显示和权限有关吗？
有关。即使模块已安装，若未在 ir.model.access 配置模型访问权限、或当前用户不在有权限的组，菜单和视图也不会显示。用管理员账号检查菜单项与访问规则是否生效。
Odoo 模块的 depends 该怎么填？
在 __manifest__.py 的 depends 列表填入该模块依赖的、且已安装模块的技术名（如 base、web、sale），缺依赖会导致安装失败或视图不加载。只写真正依赖的模块，避免冗余。
怎么排查 Odoo 模块报错？
查看 Odoo 服务运行日志，浏览器开开发者工具看控制台报错；用 -d 指定数据库并加 –dev=all 进入开发模式获取详细 traceback；重点检查 XML 视图 id 冲突、字段未定义和 Python 语法错误。
