Django项目拆分admin.py的最佳实践及import *使用建议

一、两种文件结构的适用场景 #

结构一：admin子包拆分 #

这种结构适合按功能/Model维度拆分的场景——把通用的admin基类、工具函数丢进common.py，Model A的admin配置单独放admin_a.py，Model B的放admin_b.py。好处是所有admin相关代码都集中在一个admin包下，找起来不用跨多个子文件夹，目录结构非常清晰。

结构二：按业务模块拆分admin文件 #

如果你的项目本身已经按业务模块（比如folder_a、folder_b）划分目录，这种结构更合适。把对应模块的Model admin配置直接放在模块内部的admin.py里，符合“就近维护”的原则——改某个业务模块的Model时，对应的admin配置就在同目录下，不用跳来跳去。

二、别用import *，坑真的多 #

你担心的命名空间污染、冲突、可读性问题完全是对的，import *绝对是不推荐的写法：

• 同名覆盖是重灾区：比如两个文件里都定义了CustomAdmin类，导入后直接覆盖，排查问题要疯；
• 可读性拉胯：其他开发者看代码时，根本不知道某个类/函数到底来自哪个文件；
• IDE的代码提示、lint工具也没法准确识别来源，开发效率直接打折扣。

三、更规范的替代方案 #

不管选哪种结构，都可以用下面的方式替代import *：

针对结构一（admin子包） #

不用在__init__.py里导入所有名称，只需要导入各个子文件触发注册逻辑就行：

# myapp/admin/__init__.py
from . import common, admin_a, admin_b

每个子文件里自己完成Model的注册，比如admin_a.py：

# myapp/admin/admin_a.py
from django.contrib import admin
from myapp.models import ModelA

class ModelAAdmin(admin.ModelAdmin):
    list_display = ('id', 'name')

admin.site.register(ModelA, ModelAAdmin)

要是有通用的Admin基类，就放在common.py里，其他文件按需导入：

# myapp/admin/common.py
from django.contrib import admin

class BaseAdmin(admin.ModelAdmin):
    list_per_page = 20
    ordering = ('-id',)

然后在admin_a.py里用：

from .common import BaseAdmin

class ModelAAdmin(BaseAdmin):
    # 自定义配置
    pass

针对结构二（按模块拆分） #

顶层的admin.py只需要导入各个模块的admin文件即可，不用导入具体类：

# myapp/admin.py
from .folder_a import admin
from .folder_b import admin

这样会触发模块内admin.py的执行，完成对应的Model注册，同时不会污染命名空间。

四、最佳实践总结 #

1. 选结构看项目现状：如果是按admin功能/Model拆分，用结构一；如果项目本身按业务模块划分，用结构二，保持代码就近维护。
2. 彻底抛弃import *：要么显式导入文件触发注册，要么只导入需要的类，从根源避免命名问题。
3. 注册逻辑本地化：每个Model的Admin配置和注册逻辑放在同一个文件里，不要集中到一个文件统一注册，维护时能快速定位。
4. 复用逻辑抽离：把通用的Admin基类、工具函数单独放在公共文件里，避免重复造轮子。

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