Django开发环境搭建

一、准备工作

1. 安装Python

Django是Python开发的Web框架，首先需要安装Python（推荐3.8及以上版本）。

• Windows/MacOS：
  从Python官网下载并安装。
• Linux：
  通常系统自带Python，也可用包管理器安装：

  sudo apt-get install python3 python3-pip
  

安装后，验证：

python --version
pip --version

---

2. 安装虚拟环境工具

推荐使用 venv 或 virtualenv，可以隔离项目依赖。

• 创建虚拟环境（以venv为例）：

  python -m venv myenv
  

• 激活虚拟环境：
  • Windows：

    myenv\Scripts\activate
    

  • Mac/Linux：

    source myenv/bin/activate
    

---

二、安装Django

在虚拟环境中安装Django：

pip install django

验证安装：

python -m django --version

---

三、创建Django项目

django-admin startproject myproject
cd myproject

项目结构如下：

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

---

四、运行开发服务器

python manage.py runserver

默认运行在 http://127.0.0.1:8000/，在浏览器访问即可看到欢迎页面。

---

五、创建应用（App）

Django项目可包含多个App：

python manage.py startapp myapp

App结构如下：

myapp/
    migrations/
    __init__.py
    admin.py
    apps.py
    models.py
    tests.py
    views.py

---

六、配置数据库

Django默认使用SQLite，可在 settings.py 修改为MySQL、PostgreSQL等其他数据库。

例如使用MySQL：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'your_db',
        'USER': 'your_user',
        'PASSWORD': 'your_password',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}

需要安装数据库驱动：

pip install mysqlclient

---

七、迁移数据库

每次修改models后都需要迁移：

python manage.py makemigrations
python manage.py migrate

---

八、创建超级用户

用于登录Django后台管理：

python manage.py createsuperuser

---

九、开发与调试

• 编写视图（views.py）
• 配置路由（urls.py）
• 编写模板（templates目录）
• 静态文件（static目录）

---

十、常用开发工具推荐

• IDE/编辑器：PyCharm、VS Code
• 调试工具：Django Debug Toolbar
• 版本管理：Git
• 依赖管理：requirements.txt

---

十一、Django开发流程详解

1. 视图（Views）编写

在 myapp/views.py 中编写视图函数或类视图。例如：

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django!")

2. 路由（URL）配置

在 myapp 下新建 urls.py：

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

然后在主项目 myproject/urls.py 中引入：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('myapp.urls')),
]

---

3. 模板（Templates）和静态文件（Static）

a. 模板

• 在 myapp 下新建 templates/myapp/index.html 文件。
• 在视图中渲染模板：

from django.shortcuts import render

def index(request):
    return render(request, 'myapp/index.html')

• 在 settings.py 设置模板路径（一般Django自动识别）。

b. 静态文件

• 在 myapp 下新建 static/myapp/style.css 文件。
• 在模板中使用：

 

{% load static %}
<link rel="stylesheet" href="{% static 'myapp/style.css' %}">

• 在 settings.py 设置 STATIC_URL（默认即可）。

---

4. 数据模型（Models）与管理后台

a. 定义模型

在 models.py 中定义：

from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    pub_date = models.DateTimeField(auto_now_add=True)

b. 注册模型到后台

在 admin.py 中注册：

from django.contrib import admin
from .models import Article

admin.site.register(Article)

c. 迁移数据库

python manage.py makemigrations
python manage.py migrate

---

5. 前后端交互（表单、API）

a. 表单处理

• 使用Django的 forms 模块处理表单。
• 示例：创建 forms.py 并在视图中使用。

b. REST API开发

• 推荐安装 Django REST framework：

  pip install djangorestframework
  

• 在 settings.py 中添加 'rest_framework' 到 INSTALLED_APPS。
• 编写序列化器、API视图等。

---

十二、项目结构优化建议

• 将 templates 和 static 放在每个App下，便于管理。
• 使用 settings.py 分环境（开发、生产），可用 django-environ 管理环境变量。
• 使用 requirements.txt 管理依赖：

  pip freeze > requirements.txt
  

---

十三、常见配置补充

1. 跨域配置（CORS）

• 安装 django-cors-headers：

  pip install django-cors-headers
  

• 在 settings.py 添加配置：

INSTALLED_APPS += ['corsheaders']
MIDDLEWARE = ['corsheaders.middleware.CorsMiddleware'] + MIDDLEWARE
CORS_ORIGIN_ALLOW_ALL = True  # 或者指定域名

2. 日志配置

在 settings.py 中配置 LOGGING，便于调试和生产环境监控。

---

十四、部署准备

1. 静态文件收集

python manage.py collectstatic

2. 配置生产环境数据库、安全设置

• 设置 DEBUG = False
• 配置 ALLOWED_HOSTS
• 使用强密码、HTTPS等安全措施

3. 使用Gunicorn、Nginx部署

• 安装Gunicorn：pip install gunicorn
• 配置Nginx代理，静态文件由Nginx直接服务

---

十五、常见问题与解决办法

1. 迁移失败：检查模型字段是否变更，删除旧迁移文件后重试。
2. 模块未找到：确认虚拟环境已激活，依赖已安装。
3. 静态文件不显示：检查 STATIC_URL 配置和 collectstatic 是否执行。
4. 数据库连接失败：确认数据库服务已启动，用户名密码正确。

总结

Django开发环境搭建流程：

1. 安装Python和pip
2. 创建并激活虚拟环境
3. 安装Django
4. 创建项目和应用
5. 配置数据库
6. 迁移数据库
7. 创建超级用户
8. 开发和调试