3.1 项目与应用的创建

Django6 项目与应用创建完全指南 - 新手入门教程

Django 6中文教程

本教程详细讲解Django6中项目和应用的创建方法，涵盖django-admin命令详解、项目与应用的区别与关联，以及多应用项目的创建规范，帮助初学者轻松掌握Django开发基础。

Django6 项目与应用创建教程

引言

欢迎学习Django6！Django是一个强大的Python Web框架，用于快速开发安全、可扩展的网站。本教程面向新手，详细讲解项目与应用的创建，助您从零开始上手Django6。

第一部分：项目与应用的创建

什么是Django项目和应用？

项目（Project）：Django项目是一个完整的网站或Web应用程序，包含配置、设置和多个应用的集合。它相当于一个容器，管理整体结构和环境。
应用（App）：应用是项目内的功能模块，每个应用通常处理特定任务（如用户管理、博客功能）。应用是独立的、可重用的组件。

如何创建项目？

在Django6中，创建项目使用django-admin工具。首先确保已安装Django6（可通过pip install django==6.0安装）。

打开终端或命令提示符：进入您想创建项目的目录。
运行创建项目命令：
```
django-admin startproject myproject
```
- myproject是项目名称，您可以自定义（例如：mysite）。
- 命令会生成一个名为myproject的文件夹，包含项目文件如manage.py、settings.py等。
验证项目创建：进入项目文件夹并运行开发服务器：
```
cd myproject
python manage.py runserver
```
访问http://127.0.0.1:8000/，看到Django欢迎页面表示成功。

如何创建应用？

在项目文件夹内创建应用：

确保在项目根目录（即manage.py所在目录）。
运行创建应用命令：
```
python manage.py startapp myapp
```
- myapp是应用名称，例如blog或users。
- 命令会生成一个myapp文件夹，包含应用文件如models.py、views.py。
注册应用到项目：打开项目中的settings.py文件，在INSTALLED_APPS列表中添加应用名称：
```
INSTALLED_APPS = [
    ...
    'myapp',
]
```

第二部分：django-admin 命令详解

介绍django-admin工具

django-admin是Django的命令行工具，用于管理项目和应用。常用命令：

startproject：创建新项目。
startapp：创建新应用（在项目内使用manage.py更常见）。
其他命令如migrate、createsuperuser等。

创建项目的命令：django-admin startproject

语法：django-admin startproject projectname [directory]

projectname：必需，项目名称。
[directory]：可选，指定项目创建在特定目录。示例：

# 在当前目录创建项目
 django-admin startproject myproject
# 在指定目录创建项目
 django-admin startproject myproject /path/to/directory

创建应用的命令：python manage.py startapp

在项目内，使用manage.py（Django管理脚本）创建应用：语法：python manage.py startapp appname

appname：必需，应用名称，建议使用小写字母和下划线。示例：

python manage.py startapp blog

其他相关命令

runserver：启动开发服务器。
migrate：应用数据库迁移。
makemigrations：创建迁移文件。
shell：进入Django交互式shell。

第三部分：项目与应用的区别与关联

项目的结构和作用

项目是顶层容器，包含：

manage.py：管理项目的命令行工具入口。
myproject/文件夹：项目设置目录，含settings.py（配置）、urls.py（URL路由）等。
项目负责整体配置，如数据库设置、中间件、静态文件管理。

应用的结构和作用

应用是功能模块，包含：

models.py：定义数据模型。
views.py：处理业务逻辑和视图。
urls.py：应用内的URL路由（可选，可统一在项目urls.py中定义）。
admin.py：注册模型到Django管理界面。
应用是独立的，可以在多个项目中重用。

它们如何一起工作

关联：项目通过settings.py中的INSTALLED_APPS列表包含应用，应用通过项目配置和路由集成。
工作流程：用户请求 → 项目urls.py路由 → 应用views.py处理 → 返回响应。
区别：项目是全局框架，应用是具体功能；一个项目可以有多个应用。

第四部分：多应用项目的创建规范

为什么需要多个应用？

在复杂项目中，使用多个应用可以提高代码模块化、可维护性和团队协作效率。例如：一个电商项目可以有products、orders、users等应用。

如何组织和创建多个应用？

规划应用结构：根据功能划分应用，保持每个应用职责单一。

创建应用：在项目根目录下逐个创建应用：

python manage.py startapp products
python manage.py startapp orders
python manage.py startapp users

注册所有应用：在settings.py的INSTALLED_APPS中添加所有应用：
```
INSTALLED_APPS = [
    ...
    'products',
    'orders',
    'users',
]
```

最佳实践和规范

命名规范：应用名称使用小写字母和下划线（如my_app），避免冲突。

目录结构：保持项目和应用文件夹清晰，例如：

myproject/
    manage.py
    myproject/
        settings.py
        urls.py
    products/
        models.py
        views.py
    orders/
        ...

依赖管理：应用间尽量避免循环依赖；使用Django的信号或公共模块共享代码。
迁移管理：每个应用有自己的迁移文件夹，统一通过python manage.py migrate应用。

总结

通过本教程，您已学习到Django6中项目和应用的创建方法、django-admin命令详解、项目与应用的区别与关联，以及多应用项目的创建规范。建议动手实践，创建自己的项目和应用，加深理解。Django6的文档和社区资源丰富，遇到问题可随时查阅。祝您学习顺利！

上一章 2.3 开发工具配置