如何拆分Django的models.py、views.py、serializers.py为多文件？

一、合理的目录结构规划 #

先把应用拆分成按功能/模型划分的子目录，确保每个子目录都包含__init__.py（标记为Python包），示例结构：

your_project/
├── your_app/
│   ├── __init__.py
│   ├── models/
│   │   ├── __init__.py
│   │   ├── model1.py
│   │   └── model2.py
│   ├── serializers/
│   │   ├── __init__.py
│   │   ├── model1_serializer.py
│   │   └── model2_serializer.py
│   └── views/
│       ├── __init__.py
│       ├── model1_views.py
│       └── model2_views.py

关键配置：models目录的__init__.py #

必须在your_app/models/__init__.py中导入所有模型，这样Django ORM能扫描到所有模型，同时其他模块也能统一导入：

# your_app/models/__init__.py
from .model1 import Model1
from .model2 import Model2

二、解决导入错误的具体操作 #

1. 绝对导入（推荐） #

在serializers/model1_serializer.py中使用绝对导入，路径基于项目根目录：

from your_app.models import Model1

注意：运行项目时必须从项目根目录执行命令，比如：

cd /path/to/your_project
python manage.py runserver

Django会自动把项目根目录加入Python的sys.path，无需手动添加。

2. 相对导入（仅限包内部调用） #

如果想用相对导入，要遵循包层级关系，在serializers/model1_serializer.py中：

from ..models import Model1

⚠️ 绝对不能直接运行单个serializer文件，必须通过manage.py启动项目，否则会触发ValueError: attempted relative import beyond top-level package错误。

3. 修正PyCharm配置 #

右键点击项目根目录your_project，选择Mark Directory as -> Sources Root，这样IDE和外部运行环境都会识别正确的模块路径，避免IDE内正常、外部运行报错的情况。

4. 禁用手动修改sys.path #

不要随意往sys.path中添加路径，这会导致环境混乱，依赖Django自身的路径管理即可。

三、拆分后的优化建议 #

• views层优化：在views/__init__.py中导入常用视图，方便urls.py调用：

  # your_app/views/__init__.py
  from .model1_views import Model1ListAPIView, Model1DetailAPIView
  

  然后在urls.py中可以简化导入：

  from your_app.views import Model1ListAPIView
  

• serializers层优化：同理，在serializers/__init__.py中导入常用序列化器，减少其他模块的导入代码。
• 解决循环导入：如果模型之间有关联，比如Model1引用Model2，用字符串形式指定模型名避免循环：

  # model1.py
  class Model1(models.Model):
      related_model = models.ForeignKey('Model2', on_delete=models.CASCADE)
  

  或者指定完整的应用+模型名：

  related_model = models.ForeignKey('your_app.Model2', on_delete=models.CASCADE)
  

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