Odoo 11模块找不到求助：自定义脚手架模块无法识别

Hey there! As someone who’s stumbled through early Odoo setup headaches, let’s work through solving this "No Module Found" issue step by step—no overly technical jargon, just straightforward checks.

1. Double-Check Your Module’s Structure & Manifest File #

Odoo is strict about module structure, so first confirm your custom module has these required files (the rest are optional based on your module’s functionality):

your_custom_module/
├── __init__.py  # Can be empty, but must exist
├── __manifest__.py  # Critical—this tells Odoo about your module
├── models/ (optional)
│   └── __init__.py
└── controllers/ (optional)
    └── __init__.py

Your __manifest__.py needs at least these core fields (Odoo 11 uses this instead of the older __openerp__.py):

{
    'name': 'My First Custom Module',  # Display name in Odoo's app list
    'version': '1.0',
    'depends': ['base'],  # Base is almost always a required dependency
    'author': 'Your Name',
    'category': 'Uncategorized',
    'description': """
    Short description of what your module does
    """,
    'installable': True,
    'auto_install': False,
}

If any of these files are missing or misnamed, Odoo will ignore the module entirely.

2. Update addons_path in Your odoo.conf #

This is the #1 reason for missing module errors! Odoo only scans directories listed in the addons_path setting for modules. Open your odoo.conf and make sure your custom module’s parent folder is included under the [options] section:

[options]
; ... other existing config lines ...
addons_path = /usr/lib/python3/dist-packages/odoo/addons,/absolute/path/to/your/custom/addons/folder

• Use absolute paths (no ../ or relative paths like ./my-modules)
• Separate multiple paths with a comma
• Save the file after editing

3. Restart Odoo & Refresh the Module List #

Changes to odoo.conf won’t take effect until you restart Odoo. If you installed Odoo via APT, use:

sudo systemctl restart odoo

If you’re running Odoo directly from source (like in PyCharm), stop the running process and restart it, making sure to load your updated config:

./odoo-bin -c /path/to/your/odoo.conf

Then head to your Odoo backend:

1. Go to the Apps menu
2. Click the Update Apps List button in the top-right corner
3. Enter your admin password when prompted

This forces Odoo to re-scan all directories in addons_path for new modules.

4. Fix Folder Permissions (Ubuntu-Specific) #

Ubuntu runs Odoo under the odoo user by default, so that user needs read access to your custom module folder. Fix permissions with these commands:

sudo chown -R odoo:odoo /absolute/path/to/your/custom/addons/folder
sudo chmod -R 755 /absolute/path/to/your/custom/addons/folder

5. Verify the Module Name in Odoo #

When searching for your module in the Apps menu, use the folder name (the technical name) instead of the name field from __manifest__.py—Odoo uses the folder name to identify modules internally. If you still don’t see it, enable developer mode (Apps > Settings > Activate the developer mode) and search again.

内容的提问来源于stack exchange，提问作者Yubin Qiu