Django 是一款功能强大的 Python Web 框架遵循 MVT 设计模式内置了 ORM、Admin 后台、表单验证、路由系统等众多组件能够帮助开发者快速构建高质量的 Web 应用。本文将从零开始详细讲解 Django 项目的完整配置与启动流程适合初学者快速上手也可作为日常开发的配置参考。一、环境准备1.1 Python 环境检查Django 依赖 Python 环境建议使用 Python 3.8 及以上版本。打开终端输入命令检查bash运行python --version# 或者python3 --version若未安装 Python请到 Python 官网 下载对应系统版本并安装。1.2 创建虚拟环境推荐为了隔离项目依赖避免不同项目之间的包冲突强烈建议使用虚拟环境。Windows 系统bash运行# 创建项目文件夹mkdir django_projectcd django_project# 创建虚拟环境python -m venv venv# 激活虚拟环境venv\Scripts\activateMac/Linux 系统bash运行mkdir django_projectcd django_projectpython3 -m venv venvsource venv/bin/activate激活成功后命令行前缀会出现 (venv) 标识。二、安装 Django虚拟环境激活后使用 pip 安装 Django。本文以 Django 4.2 LTS 版本为例bash运行pip install django4.2如果不指定版本默认安装最新版bash运行pip install django安装完成后验证版本bash运行django-admin --version三、创建 Django 项目在当前目录下使用 django-admin 命令创建项目项目名自定义例如 myprojectbash运行django-admin startproject myproject创建完成后进入项目根目录bash运行cd myproject此时项目目录结构如下plaintextmyproject/├── manage.py # 项目管理命令行工具└── myproject/ # 项目主配置包├── __init__.py├── asgi.py # ASGI 部署入口├── settings.py # 项目全局配置文件├── urls.py # 项目路由配置└── wsgi.py # WSGI 部署入口四、项目基础配置settings.py打开 myproject/settings.py 文件进行常用基础配置。4.1 调试模式与允许访问主机python运行# 开发环境设为 True生产环境必须设为 FalseDEBUG True# 允许访问的主机IP开发阶段可设为 *ALLOWED_HOSTS [*]4.2 语言与时区设置默认是英文和 UTC 时区修改为中文和上海时区python运行# 中文LANGUAGE_CODE zh-hans# 上海时区TIME_ZONE Asia/ShanghaiUSE_I18N TrueUSE_TZ True4.3 静态文件配置python运行# 静态文件访问前缀STATIC_URL static/# 静态文件收集目录部署时使用STATIC_ROOT os.path.join(BASE_DIR, static)4.4 媒体文件配置可选如果项目涉及文件上传添加媒体文件配置python运行# 媒体文件访问前缀MEDIA_URL media/# 媒体文件存储路径MEDIA_ROOT os.path.join(BASE_DIR, media)五、创建应用AppDjango 推荐按功能模块拆分应用App一个项目可以包含多个应用。5.1 创建 App在项目根目录manage.py 同级执行bash运行python manage.py startapp app01这里 app01 是应用名可根据业务命名如 users、blog 等。5.2 注册 App创建完 App 后必须在 settings.py 的 INSTALLED_APPS 中注册python运行INSTALLED_APPS [django.contrib.admin,django.contrib.auth,django.contrib.contenttypes,django.contrib.sessions,django.contrib.messages,django.contrib.staticfiles,# 注册自定义应用app01,]六、数据库配置Django 默认使用 SQLite 数据库无需额外安装即可使用。如果需要使用 MySQL 等其他数据库可按如下方式配置。6.1 默认 SQLite开发推荐python运行DATABASES {default: {ENGINE: django.db.backends.sqlite3,NAME: BASE_DIR / db.sqlite3,}}6.2 MySQL 配置可选首先安装 MySQL 驱动bash运行pip install pymysql然后在项目主包的 __init__.py 中添加python运行import pymysqlpymysql.install_as_MySQLdb()最后修改 settings.pypython运行DATABASES {default: {ENGINE: django.db.backends.mysql,NAME: 数据库名,USER: 用户名,PASSWORD: 密码,HOST: 127.0.0.1,PORT: 3306,CHARSET: utf8mb4,}}6.3 执行数据库迁移Django 内置的 Auth、Session 等模块需要创建表执行迁移命令bash运行# 生成迁移文件python manage.py makemigrations# 执行迁移创建数据表python manage.py migrate七、创建超级管理员Django 自带强大的 Admin 后台管理系统创建管理员账号bash运行python manage.py createsuperuser按照提示依次输入用户名、邮箱、密码即可。密码强度不足时会提示是否继续输入 y 确认。八、启动项目一切配置就绪后启动 Django 开发服务器bash运行python manage.py runserver默认启动在 8000 端口浏览器访问项目首页http://127.0.0.1:8000/Admin 后台http://127.0.0.1:8000/admin如需指定端口bash运行python manage.py runserver 8080允许局域网访问bash运行python manage.py runserver 0.0.0.0:8000九、快速编写第一个视图9.1 编写视图函数在 app01/views.py 中添加python运行from django.http import HttpResponsedef index(request):return HttpResponse(Hello Django! 我的第一个Django页面)9.2 配置路由在 app01 目录下新建 urls.pypython运行from django.urls import pathfrom . import viewsurlpatterns [path(, views.index, nameindex),]然后在项目主路由 myproject/urls.py 中包含子路由python运行from django.contrib import adminfrom django.urls import path, includeurlpatterns [path(admin/, admin.site.urls),path(, include(app01.urls)),]重启服务后访问首页即可看到输出内容。十、常见问题汇总端口被占用更换端口号或关闭占用端口的进程迁移报错检查数据库配置是否正确数据库服务是否启动静态文件 404确认 STATIC_URL 配置正确开发环境 Django 自动处理静态文件Admin 页面样式丢失生产环境需配置 STATIC_ROOT 并执行 collectstatic总结以上就是 Django 项目从环境搭建到项目启动的完整配置流程。掌握这套基础流程后就可以开始编写业务逻辑、设计模型、开发接口了。Django 的生态非常丰富后续还可以集成 DRF、Redis、Celery 等组件构建更复杂的企业级应用。 Django 项目完整配置流程（从环境搭建到项目启动）
Django 是一款功能强大的 Python Web 框架遵循 MVT 设计模式内置了 ORM、Admin 后台、表单验证、路由系统等众多组件能够帮助开发者快速构建高质量的 Web 应用。本文将从零开始详细讲解 Django 项目的完整配置与启动流程适合初学者快速上手也可作为日常开发的配置参考。一、环境准备1.1 Python 环境检查Django 依赖 Python 环境建议使用 Python 3.8 及以上版本。打开终端输入命令检查bash运行python --version# 或者python3 --version若未安装 Python请到 Python 官网 下载对应系统版本并安装。1.2 创建虚拟环境推荐为了隔离项目依赖避免不同项目之间的包冲突强烈建议使用虚拟环境。Windows 系统bash运行# 创建项目文件夹mkdir django_projectcd django_project# 创建虚拟环境python -m venv venv# 激活虚拟环境venv\Scripts\activateMac/Linux 系统bash运行mkdir django_projectcd django_projectpython3 -m venv venvsource venv/bin/activate激活成功后命令行前缀会出现 (venv) 标识。二、安装 Django虚拟环境激活后使用 pip 安装 Django。本文以 Django 4.2 LTS 版本为例bash运行pip install django4.2如果不指定版本默认安装最新版bash运行pip install django安装完成后验证版本bash运行django-admin --version三、创建 Django 项目在当前目录下使用 django-admin 命令创建项目项目名自定义例如 myprojectbash运行django-admin startproject myproject创建完成后进入项目根目录bash运行cd myproject此时项目目录结构如下plaintextmyproject/├── manage.py # 项目管理命令行工具└── myproject/ # 项目主配置包├── __init__.py├── asgi.py # ASGI 部署入口├── settings.py # 项目全局配置文件├── urls.py # 项目路由配置└── wsgi.py # WSGI 部署入口四、项目基础配置settings.py打开 myproject/settings.py 文件进行常用基础配置。4.1 调试模式与允许访问主机python运行# 开发环境设为 True生产环境必须设为 FalseDEBUG True# 允许访问的主机IP开发阶段可设为 *ALLOWED_HOSTS [*]4.2 语言与时区设置默认是英文和 UTC 时区修改为中文和上海时区python运行# 中文LANGUAGE_CODE zh-hans# 上海时区TIME_ZONE Asia/ShanghaiUSE_I18N TrueUSE_TZ True4.3 静态文件配置python运行# 静态文件访问前缀STATIC_URL static/# 静态文件收集目录部署时使用STATIC_ROOT os.path.join(BASE_DIR, static)4.4 媒体文件配置可选如果项目涉及文件上传添加媒体文件配置python运行# 媒体文件访问前缀MEDIA_URL media/# 媒体文件存储路径MEDIA_ROOT os.path.join(BASE_DIR, media)五、创建应用AppDjango 推荐按功能模块拆分应用App一个项目可以包含多个应用。5.1 创建 App在项目根目录manage.py 同级执行bash运行python manage.py startapp app01这里 app01 是应用名可根据业务命名如 users、blog 等。5.2 注册 App创建完 App 后必须在 settings.py 的 INSTALLED_APPS 中注册python运行INSTALLED_APPS [django.contrib.admin,django.contrib.auth,django.contrib.contenttypes,django.contrib.sessions,django.contrib.messages,django.contrib.staticfiles,# 注册自定义应用app01,]六、数据库配置Django 默认使用 SQLite 数据库无需额外安装即可使用。如果需要使用 MySQL 等其他数据库可按如下方式配置。6.1 默认 SQLite开发推荐python运行DATABASES {default: {ENGINE: django.db.backends.sqlite3,NAME: BASE_DIR / db.sqlite3,}}6.2 MySQL 配置可选首先安装 MySQL 驱动bash运行pip install pymysql然后在项目主包的 __init__.py 中添加python运行import pymysqlpymysql.install_as_MySQLdb()最后修改 settings.pypython运行DATABASES {default: {ENGINE: django.db.backends.mysql,NAME: 数据库名,USER: 用户名,PASSWORD: 密码,HOST: 127.0.0.1,PORT: 3306,CHARSET: utf8mb4,}}6.3 执行数据库迁移Django 内置的 Auth、Session 等模块需要创建表执行迁移命令bash运行# 生成迁移文件python manage.py makemigrations# 执行迁移创建数据表python manage.py migrate七、创建超级管理员Django 自带强大的 Admin 后台管理系统创建管理员账号bash运行python manage.py createsuperuser按照提示依次输入用户名、邮箱、密码即可。密码强度不足时会提示是否继续输入 y 确认。八、启动项目一切配置就绪后启动 Django 开发服务器bash运行python manage.py runserver默认启动在 8000 端口浏览器访问项目首页http://127.0.0.1:8000/Admin 后台http://127.0.0.1:8000/admin如需指定端口bash运行python manage.py runserver 8080允许局域网访问bash运行python manage.py runserver 0.0.0.0:8000九、快速编写第一个视图9.1 编写视图函数在 app01/views.py 中添加python运行from django.http import HttpResponsedef index(request):return HttpResponse(Hello Django! 我的第一个Django页面)9.2 配置路由在 app01 目录下新建 urls.pypython运行from django.urls import pathfrom . import viewsurlpatterns [path(, views.index, nameindex),]然后在项目主路由 myproject/urls.py 中包含子路由python运行from django.contrib import adminfrom django.urls import path, includeurlpatterns [path(admin/, admin.site.urls),path(, include(app01.urls)),]重启服务后访问首页即可看到输出内容。十、常见问题汇总端口被占用更换端口号或关闭占用端口的进程迁移报错检查数据库配置是否正确数据库服务是否启动静态文件 404确认 STATIC_URL 配置正确开发环境 Django 自动处理静态文件Admin 页面样式丢失生产环境需配置 STATIC_ROOT 并执行 collectstatic总结以上就是 Django 项目从环境搭建到项目启动的完整配置流程。掌握这套基础流程后就可以开始编写业务逻辑、设计模型、开发接口了。Django 的生态非常丰富后续还可以集成 DRF、Redis、Celery 等组件构建更复杂的企业级应用。