Python 编程实战 · 实用工具与库 — Django 项目结构简介 - 指南

Django 是 Python 中最成熟的 Web 框架之一，内置 ORM、模板引擎、权限系统、后台管理等完整功能，非常适合构建中大型 Web 应用。

刚创建 Django 项目时，新手最疑惑的问题之一就是：
“这些文件夹到底是干什么的？”

本篇内容将带你彻底理解 Django 的项目结构，掌握一个 Django 项目应该如何组织与运行。

---

一、创建 Django 项目

假设您已经安装 Django：

pip install django

创建项目：

django-admin startproject mysite

结构如下：

mysite/manage.pymysite/__init__.pysettings.pyurls.pyasgi.pywsgi.py

---

二、项目根目录结构讲解

下面是 Django 项目默认目录的解释。

---

1. manage.py —— 项目管理命令入口

你在开发中最常用的命令几乎都从这里运行：

python manage.py runserver
python manage.py migrate
python manage.py createsuperuser
python manage.py startapp app1

作用：

• 提供 Django 命令行工具入口
• 自动配置 Django 环境变量

---

2. 项目主目录（与项目同名）

第二层的 mysite/ 才是真正的项目配置目录，这里包含项目级别的配置文件。

结构如下：

mysite/__init__.pysettings.pyurls.pyasgi.pywsgi.py

让我们逐个介绍：

---

2.1 settings.py —— 项目核心配置文件

settings.py 是 Django 项目的“大脑”，里面包含所有全局配置，例如：

• INSTALLED_APPS（安装的组件）
• DATABASES（数据库配置）
• MIDDLEWARE（中间件）
• TEMPLATES（模板设置）
• STATICFILES（静态文件路径）
• DEBUG 开关

你修改最多的文件就是这个。

---