Django应用创建 - startapp命令与模块化开发指南

一、概述

Django项目由多个应用（App）组成，每个应用是一个功能模块。应用是可复用的Python包，包含模型、视图、模板等。通过startapp命令创建应用，然后在settings.py中注册。Django鼓励将功能拆分为独立应用，实现代码的模块化和复用。

应用是Django架构中的核心概念，一个项目可以包含多个应用，每个应用负责特定的功能领域。例如，一个博客项目可能包含文章管理应用、评论应用、用户管理应用等。应用之间可以相互独立，也可以通过外键等关系进行关联。

二、语法与参数

创建Django应用的语法非常简单：

# 创建应用
python manage.py startapp app_name

startapp 参数

三、应用目录结构

创建应用后，Django会自动生成以下文件：

注册应用

创建应用后，需要在settings.py的INSTALLED_APPS中注册：

# settings.py
INSTALLED_APPS = [
    ...,
    'app_name',
    # 或
    'app_name.apps.AppNameConfig',
]

使用app_name直接注册是简写方式，Django会自动找到应用配置类。使用app_name.apps.AppNameConfig是完整路径方式，可以更精确地控制应用配置。

四、代码示例

示例1：创建并注册应用

# 创建应用
python manage.py startapp blog

# 查看应用结构
tree blog

输出：

blog/
├── __init__.py
├── admin.py
├── apps.py
├── migrations/
│   └── __init__.py
├── models.py
├── tests.py
└── views.py

# settings.py 注册应用
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',  # 注册blog应用
]

示例2：应用配置类

# blog/apps.py
from django.apps import AppConfig

class BlogConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'blog'
    verbose_name = '博客管理'

    def ready(self):
        """应用启动时执行"""
        # 可以在此处注册信号、检查依赖等
        pass

• name：应用的完整Python路径

• verbose_name：应用的人类可读名称，显示在Admin后台

• default_auto_field：默认主键字段类型，Django 3.2+新增

• ready()：应用加载完成后调用的方法，常用于注册信号处理器

示例3：创建应用的完整流程

# 1. 创建项目
django-admin startproject mysite
cd mysite

# 2. 创建应用
python manage.py startapp blog

# 3. 注册应用（编辑settings.py）
# 在INSTALLED_APPS中添加'blog'

# 4. 创建模型（编辑blog/models.py）
# 定义Article、Comment等模型

# 5. 创建迁移
python manage.py makemigrations blog

# 6. 执行迁移
python manage.py migrate

# 7. 创建视图（编辑blog/views.py）
# 定义index、detail等视图函数

# 8. 配置URL（编辑blog/urls.py和mysite/urls.py）
# 设置URL路由映射

# 9. 运行服务器
python manage.py runserver

这是从零开始创建一个完整Django应用的标准流程。每个步骤都是必需的，顺序也不能随意更改。特别是makemigrations和migrate必须在修改模型后执行，以确保数据库结构与模型定义同步。

五、实际应用场景

• 博客系统中的文章管理应用：创建独立的blog应用，管理文章、分类、标签等内容，可复用到其他项目中

• 电商系统中的独立应用：将商品、订单、用户等拆分为独立应用，各应用职责单一，便于维护和扩展

• 可复用应用封装：将通用功能（如用户认证、文件上传、支付接口）封装为独立应用，在多个项目中共享使用

六、注意事项

注意：创建应用后必须在settings.py的INSTALLED_APPS中注册才能生效，否则Django无法识别该应用，模型迁移和Admin注册都会失败。

注意：应用名称应使用小写字母，多个单词用下划线连接，如user_profile。避免使用Django保留字如admin、auth等。

注意：urls.py文件不会自动创建，需手动创建并配置。这是Django 2.0之后的变化，早期版本会自动生成urls.py。

注意：一个项目可以包含多个应用，一个应用也可以在多个项目中复用。设计应用时应尽量保持低耦合高内聚，提高复用性。

七、项目与应用对比

八、小结

• 应用是Django的功能模块，通过startapp命令创建

• 创建后必须在settings.py中注册

• 应用包含models、views、admin、tests等文件

• urls.py需手动创建，用于配置应用级URL

九、练习题