Django项目实战教程从环境搭建到成品输出的完整开发指南包含数据库设计模板创建视图函数配置和部署上线

威震华夏关云长

引言

Django是一个基于Python的高级Web框架，它鼓励快速开发和干净、实用的设计。本教程将带您从零开始，一步步构建一个完整的Django项目，涵盖环境搭建、数据库设计、模板创建、视图函数配置以及最终部署上线的全过程。无论您是Django新手还是有一定经验的开发者，本教程都将为您提供实用的指导和最佳实践。

1. 环境搭建

1.1 Python环境安装

在开始Django开发之前，首先需要确保您的系统上安装了Python。Django 3.2+版本需要Python 3.6或更高版本。

2. # 检查Python版本
3. python --version
4. # 或
5. python3 --version

复制代码

如果尚未安装Python，请访问Python官网下载并安装适合您操作系统的版本。

1.2 虚拟环境创建

使用虚拟环境可以隔离不同项目的依赖，避免包版本冲突。推荐使用venv模块创建虚拟环境：

2. # 创建虚拟环境
3. python -m venv myproject_env
5. # 激活虚拟环境
6. # Windows
7. myproject_env\Scripts\activate
8. # macOS/Linux
9. source myproject_env/bin/activate

复制代码

1.3 Django安装

激活虚拟环境后，使用pip安装Django：

2. # 安装Django
3. pip install django
5. # 验证Django安装
6. python -m django --version

复制代码

1.4 开发工具选择

选择一个合适的IDE或文本编辑器可以提高开发效率。推荐使用：

• PyCharm（专业版或社区版）
• Visual Studio Code（安装Python和Django插件）
• Sublime Text

2. 项目创建与配置

2.1 创建Django项目

使用Django的命令行工具创建新项目：

2. # 创建项目
3. django-admin startproject myproject
5. # 进入项目目录
6. cd myproject

复制代码

2.2 项目结构解析

创建的项目结构如下：

2. myproject/
3.     manage.py
4.     myproject/
5.         __init__.py
6.         settings.py
7.         urls.py
8.         asgi.py
9.         wsgi.py

复制代码

• manage.py：Django的命令行工具，用于管理项目
• settings.py：项目的配置文件
• urls.py：项目的URL声明
• wsgi.py：WSGI兼容的Web服务器入口
• asgi.py：ASGI兼容的Web服务器入口

2.3 项目基本配置

编辑settings.py文件，进行基本配置：

2. # settings.py
4. import os
5. from pathlib import Path
7. # 构建路径
8. BASE_DIR = Path(__file__).resolve().parent.parent
10. # 安全密钥
11. SECRET_KEY = 'django-insecure-your-secret-key-here'
13. # 调试模式（生产环境应设为False）
14. DEBUG = True
16. # 允许的主机
17. ALLOWED_HOSTS = []
19. # 已安装的应用
20. INSTALLED_APPS = [
21.     'django.contrib.admin',
22.     'django.contrib.auth',
23.     'django.contrib.contenttypes',
24.     'django.contrib.sessions',
25.     'django.contrib.messages',
26.     'django.contrib.staticfiles',
27. ]
29. # 中间件
30. MIDDLEWARE = [
31.     'django.middleware.security.SecurityMiddleware',
32.     'django.contrib.sessions.middleware.SessionMiddleware',
33.     'django.middleware.common.CommonMiddleware',
34.     'django.middleware.csrf.CsrfViewMiddleware',
35.     'django.contrib.auth.middleware.AuthenticationMiddleware',
36.     'django.contrib.messages.middleware.MessageMiddleware',
37.     'django.middleware.clickjacking.XFrameOptionsMiddleware',
38. ]
40. # 根URL配置
41. ROOT_URLCONF = 'myproject.urls'
43. # 模板配置
44. TEMPLATES = [
45.     {
46.         'BACKEND': 'django.template.backends.django.DjangoTemplates',
47.         'DIRS': [BASE_DIR / 'templates'],
48.         'APP_DIRS': True,
49.         'OPTIONS': {
50.             'context_processors': [
51.                 'django.template.context_processors.debug',
52.                 'django.template.context_processors.request',
53.                 'django.contrib.auth.context_processors.auth',
54.                 'django.contrib.messages.context_processors.messages',
55.             ],
56.         },
57.     },
58. ]
60. # WSGI应用
61. WSGI_APPLICATION = 'myproject.wsgi.application'
63. # 数据库配置
64. DATABASES = {
65.     'default': {
66.         'ENGINE': 'django.db.backends.sqlite3',
67.         'NAME': BASE_DIR / 'db.sqlite3',
68.     }
69. }
71. # 密码验证
72. AUTH_PASSWORD_VALIDATORS = [
73.     {
74.         'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
75.     },
76.     {
77.         'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
78.     },
79.     {
80.         'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
81.     },
82.     {
83.         'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
84.     },
85. ]
87. # 国际化
88. LANGUAGE_CODE = 'en-us'
89. TIME_ZONE = 'UTC'
90. USE_I18N = True
91. USE_L10N = True
92. USE_TZ = True
94. # 静态文件
95. STATIC_URL = '/static/'
96. STATICFILES_DIRS = [
97.     BASE_DIR / 'static',
98. ]
100. # 默认主键字段类型
101. DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'

复制代码

2.4 创建应用

在Django中，应用是项目的功能模块。创建一个应用：

2. # 创建应用
3. python manage.py startapp blog
5. # 目录结构
6. blog/
7.     __init__.py
8.     admin.py
9.     apps.py
10.     migrations/
11.     models.py
12.     tests.py
13.     views.py

复制代码

将新创建的应用添加到settings.py的INSTALLED_APPS中：

2. # settings.py
3. INSTALLED_APPS = [
4.     # ...其他应用
5.     'blog',  # 添加我们的应用
6. ]

复制代码

3. 数据库设计

3.1 模型定义

模型是数据的单一、明确的信息源。在blog/models.py中定义模型：

2. # blog/models.py
3. from django.db import models
4. from django.contrib.auth.models import User
5. from django.utils import timezone
7. class Category(models.Model):
8.     name = models.CharField(max_length=100, unique=True)
9.     slug = models.SlugField(max_length=100, unique=True)
10.     description = models.TextField(blank=True)
11.    
12.     class Meta:
13.         verbose_name_plural = 'Categories'
14.    
15.     def __str__(self):
16.         return self.name
18. class Tag(models.Model):
19.     name = models.CharField(max_length=100, unique=True)
20.     slug = models.SlugField(max_length=100, unique=True)
21.    
22.     def __str__(self):
23.         return self.name
25. class Post(models.Model):
26.     STATUS_CHOICES = (
27.         ('draft', 'Draft'),
28.         ('published', 'Published'),
29.     )
30.    
31.     title = models.CharField(max_length=200, unique=True)
32.     slug = models.SlugField(max_length=200, unique=True)
33.     author = models.ForeignKey(User, on_delete=models.CASCADE, related_name='blog_posts')
34.     content = models.TextField()
35.     featured_image = models.ImageField(upload_to='post_images/', blank=True)
36.     created_at = models.DateTimeField(auto_now_add=True)
37.     updated_at = models.DateTimeField(auto_now=True)
38.     status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='draft')
39.     categories = models.ManyToManyField(Category, related_name='posts')
40.     tags = models.ManyToManyField(Tag, related_name='posts', blank=True)
41.    
42.     class Meta:
43.         ordering = ['-created_at']
44.    
45.     def __str__(self):
46.         return self.title
48. class Comment(models.Model):
49.     post = models.ForeignKey(Post, on_delete=models.CASCADE, related_name='comments')
50.     name = models.CharField(max_length=100)
51.     email = models.EmailField()
52.     content = models.TextField()
53.     created_at = models.DateTimeField(auto_now_add=True)
54.     approved = models.BooleanField(default=True)
55.    
56.     class Meta:
57.         ordering = ['created_at']
58.    
59.     def __str__(self):
60.         return f'Comment by {self.name} on {self.post}'

复制代码

3.2 数据库迁移

创建模型后，需要生成并应用迁移文件：

2. # 生成迁移文件
3. python manage.py makemigrations
5. # 应用迁移
6. python manage.py migrate

复制代码

3.3 注册模型到管理界面

为了在Django管理界面中管理模型，在blog/admin.py中注册它们：

2. # blog/admin.py
3. from django.contrib import admin
4. from .models import Category, Tag, Post, Comment
6. @admin.register(Category)
7. class CategoryAdmin(admin.ModelAdmin):
8.     list_display = ['name', 'slug']
9.     prepopulated_fields = {'slug': ('name',)}
11. @admin.register(Tag)
12. class TagAdmin(admin.ModelAdmin):
13.     list_display = ['name', 'slug']
14.     prepopulated_fields = {'slug': ('name',)}
16. @admin.register(Post)
17. class PostAdmin(admin.ModelAdmin):
18.     list_display = ['title', 'author', 'status', 'created_at']
19.     list_filter = ['status', 'created_at', 'author']
20.     search_fields = ['title', 'content']
21.     prepopulated_fields = {'slug': ('title',)}
22.     raw_id_fields = ['author']
23.     date_hierarchy = 'created_at'
24.     ordering = ['status', '-created_at']
25.     filter_horizontal = ['categories', 'tags']
27. @admin.register(Comment)
28. class CommentAdmin(admin.ModelAdmin):
29.     list_display = ['name', 'post', 'created_at', 'approved']
30.     list_filter = ['approved', 'created_at']
31.     search_fields = ['name', 'email', 'content']

复制代码

3.4 创建超级用户

为了访问Django管理界面，需要创建一个超级用户：

2. # 创建超级用户
3. python manage.py createsuperuser

复制代码

按照提示输入用户名、邮箱和密码。

4. 模板创建

4.1 项目模板结构

在项目根目录下创建模板目录结构：

2. myproject/
3.     templates/
4.         base.html
5.         blog/
6.             post_list.html
7.             post_detail.html
8.             post_form.html
9.     static/
10.         css/
11.             style.css
12.         js/
13.             main.js
14.         images/

复制代码

4.2 基础模板

创建templates/base.html作为基础模板：

2. <!DOCTYPE html>
3. <html lang="en">
4. <head>
5.     <meta charset="UTF-8">
6.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
7.     <title>{% block title %}My Blog{% endblock %}</title>
8.     <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css">
9.     <link rel="stylesheet" href="{% static 'css/style.css' %}">
10.     {% block extra_css %}{% endblock %}
11. </head>
12. <body>
13.     <header>
14.         <nav class="navbar navbar-expand-lg navbar-dark bg-dark">
15.             <div class="container">
16.                 <a class="navbar-brand" href="{% url 'blog:post_list' %}">My Blog</a>
17.                 <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav">
18.                     <span class="navbar-toggler-icon"></span>
19.                 </button>
20.                 <div class="collapse navbar-collapse" id="navbarNav">
21.                     <ul class="navbar-nav mr-auto">
22.                         <li class="nav-item">
23.                             <a class="nav-link" href="{% url 'blog:post_list' %}">Home</a>
24.                         </li>
25.                         <li class="nav-item">
26.                             <a class="nav-link" href="#">About</a>
27.                         </li>
28.                         <li class="nav-item">
29.                             <a class="nav-link" href="#">Contact</a>
30.                         </li>
31.                     </ul>
32.                     <ul class="navbar-nav">
33.                         {% if user.is_authenticated %}
34.                             <li class="nav-item">
35.                                 <a class="nav-link" href="{% url 'admin:index' %}">Admin</a>
36.                             </li>
37.                             <li class="nav-item">
38.                                 <a class="nav-link" href="{% url 'logout' %}">Logout</a>
39.                             </li>
40.                         {% else %}
41.                             <li class="nav-item">
42.                                 <a class="nav-link" href="{% url 'login' %}">Login</a>
43.                             </li>
44.                         {% endif %}
45.                     </ul>
46.                 </div>
47.             </div>
48.         </nav>
49.     </header>
51.     <main class="container mt-4">
52.         <div class="row">
53.             <div class="col-md-8">
54.                 {% block content %}{% endblock %}
55.             </div>
56.             <div class="col-md-4">
57.                 <aside>
58.                     <div class="card mb-4">
59.                         <div class="card-header">
60.                             <h5>Categories</h5>
61.                         </div>
62.                         <div class="card-body">
63.                             <ul class="list-group">
64.                                 {% for category in categories %}
65.                                     <li class="list-group-item">
66.                                         <a href="{% url 'blog:post_list_by_category' category.slug %}">{{ category.name }}</a>
67.                                         <span class="badge badge-primary float-right">{{ category.posts.count }}</span>
68.                                     </li>
69.                                 {% endfor %}
70.                             </ul>
71.                         </div>
72.                     </div>
73.                     
74.                     <div class="card mb-4">
75.                         <div class="card-header">
76.                             <h5>Tags</h5>
77.                         </div>
78.                         <div class="card-body">
79.                             {% for tag in tags %}
80.                                 <a href="{% url 'blog:post_list_by_tag' tag.slug %}" class="badge badge-info mr-1">{{ tag.name }}</a>
81.                             {% endfor %}
82.                         </div>
83.                     </div>
84.                 </aside>
85.             </div>
86.         </div>
87.     </main>
89.     <footer class="bg-dark text-white py-4 mt-5">
90.         <div class="container">
91.             <div class="row">
92.                 <div class="col-md-6">
93.                     <h5>My Blog</h5>
94.                     <p>A simple blog built with Django</p>
95.                 </div>
96.                 <div class="col-md-6 text-md-right">
97.                     <p>&copy; {% now "Y" %} My Blog. All rights reserved.</p>
98.                 </div>
99.             </div>
100.         </div>
101.     </footer>
103.     <script src="https://code.jquery.com/jquery-3.5.1.slim.min.js"></script>
104.     <script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.5.3/dist/umd/popper.min.js"></script>
105.     <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js"></script>
106.     <script src="{% static 'js/main.js' %}"></script>
107.     {% block extra_js %}{% endblock %}
108. </body>
109. </html>

复制代码

4.3 文章列表模板

创建templates/blog/post_list.html：

2. {% extends 'base.html' %}
3. {% load static %}
5. {% block title %}Blog - {{ block.super }}{% endblock %}
7. {% block content %}
8.     <h1>Blog Posts</h1>
9.    
10.     {% for post in posts %}
11.         <article class="card mb-4">
12.             {% if post.featured_image %}
13.                 <img src="{{ post.featured_image.url }}" class="card-img-top" alt="{{ post.title }}">
14.             {% endif %}
15.             <div class="card-body">
16.                 <h2 class="card-title">
17.                     <a href="{{ post.get_absolute_url }}">{{ post.title }}</a>
18.                 </h2>
19.                 <p class="text-muted">
20.                     By {{ post.author }} on {{ post.created_at|date:"F d, Y" }}
21.                 </p>
22.                 <p class="card-text">{{ post.content|truncatewords:30 }}</p>
23.                 <a href="{{ post.get_absolute_url }}" class="btn btn-primary">Read More &rarr;</a>
24.             </div>
25.             <div class="card-footer text-muted">
26.                 <div class="d-flex justify-content-between">
27.                     <div>
28.                         Categories:
29.                         {% for category in post.categories.all %}
30.                             <a href="{% url 'blog:post_list_by_category' category.slug %}">{{ category.name }}</a>{% if not forloop.last %}, {% endif %}
31.                         {% endfor %}
32.                     </div>
33.                     <div>
34.                         Tags:
35.                         {% for tag in post.tags.all %}
36.                             <a href="{% url 'blog:post_list_by_tag' tag.slug %}">{{ tag.name }}</a>{% if not forloop.last %}, {% endif %}
37.                         {% endfor %}
38.                     </div>
39.                 </div>
40.             </div>
41.         </article>
42.     {% empty %}
43.         <p>No posts found.</p>
44.     {% endfor %}
45.    
46.     <!-- Pagination -->
47.     {% if is_paginated %}
48.         <nav aria-label="Page navigation">
49.             <ul class="pagination justify-content-center">
50.                 {% if page_obj.has_previous %}
51.                     <li class="page-item">
52.                         <a class="page-link" href="?page={{ page_obj.previous_page_number }}" aria-label="Previous">
53.                             <span aria-hidden="true">&laquo;</span>
54.                         </a>
55.                     </li>
56.                 {% endif %}
57.                
58.                 {% for num in page_obj.paginator.page_range %}
59.                     {% if page_obj.number == num %}
60.                         <li class="page-item active">
61.                             <span class="page-link">{{ num }}</span>
62.                         </li>
63.                     {% elif num > page_obj.number|add:'-3' and num < page_obj.number|add:'3' %}
64.                         <li class="page-item">
65.                             <a class="page-link" href="?page={{ num }}">{{ num }}</a>
66.                         </li>
67.                     {% endif %}
68.                 {% endfor %}
69.                
70.                 {% if page_obj.has_next %}
71.                     <li class="page-item">
72.                         <a class="page-link" href="?page={{ page_obj.next_page_number }}" aria-label="Next">
73.                             <span aria-hidden="true">&raquo;</span>
74.                         </a>
75.                     </li>
76.                 {% endif %}
77.             </ul>
78.         </nav>
79.     {% endif %}
80. {% endblock %}

复制代码

4.4 文章详情模板

创建templates/blog/post_detail.html：

2. {% extends 'base.html' %}
3. {% load static %}
5. {% block title %}{{ post.title }} - {{ block.super }}{% endblock %}
7. {% block content %}
8.     <article class="card mb-4">
9.         {% if post.featured_image %}
10.             <img src="{{ post.featured_image.url }}" class="card-img-top" alt="{{ post.title }}">
11.         {% endif %}
12.         <div class="card-body">
13.             <h1 class="card-title">{{ post.title }}</h1>
14.             <p class="text-muted">
15.                 By {{ post.author }} on {{ post.created_at|date:"F d, Y" }}
16.             </p>
17.             <div class="card-text">
18.                 {{ post.content|linebreaks }}
19.             </div>
20.             
21.             <div class="mt-4">
22.                 <div class="mb-2">
23.                     <strong>Categories:</strong>
24.                     {% for category in post.categories.all %}
25.                         <a href="{% url 'blog:post_list_by_category' category.slug %}" class="badge badge-info">{{ category.name }}</a>
26.                     {% endfor %}
27.                 </div>
28.                 <div>
29.                     <strong>Tags:</strong>
30.                     {% for tag in post.tags.all %}
31.                         <a href="{% url 'blog:post_list_by_tag' tag.slug %}" class="badge badge-secondary">{{ tag.name }}</a>
32.                     {% endfor %}
33.                 </div>
34.             </div>
35.         </div>
36.     </article>
37.    
38.     <!-- Comments Section -->
39.     <div class="card mb-4">
40.         <div class="card-header">
41.             <h4>Comments ({{ post.comments.count }})</h4>
42.         </div>
43.         <div class="card-body">
44.             {% for comment in post.comments.all %}
45.                 {% if comment.approved %}
46.                     <div class="media mb-4">
47.                         <div class="media-body">
48.                             <h5 class="mt-0">{{ comment.name }}</h5>
49.                             <p class="text-muted">{{ comment.created_at|date:"F d, Y, P" }}</p>
50.                             <p>{{ comment.content|linebreaks }}</p>
51.                         </div>
52.                     </div>
53.                 {% endif %}
54.             {% empty %}
55.                 <p>No comments yet.</p>
56.             {% endfor %}
57.             
58.             <!-- Comment Form -->
59.             <hr>
60.             <h5>Leave a Comment</h5>
61.             <form method="post" action="{% url 'blog:add_comment' post.id %}">
62.                 {% csrf_token %}
63.                 <div class="form-group">
64.                     <label for="id_name">Name</label>
65.                     <input type="text" class="form-control" name="name" id="id_name" required>
66.                 </div>
67.                 <div class="form-group">
68.                     <label for="id_email">Email</label>
69.                     <input type="email" class="form-control" name="email" id="id_email" required>
70.                 </div>
71.                 <div class="form-group">
72.                     <label for="id_content">Comment</label>
73.                     <textarea class="form-control" name="content" id="id_content" rows="3" required></textarea>
74.                 </div>
75.                 <button type="submit" class="btn btn-primary">Submit</button>
76.             </form>
77.         </div>
78.     </div>
79. {% endblock %}

复制代码

4.5 文章表单模板

创建templates/blog/post_form.html：

2. {% extends 'base.html' %}
3. {% load static %}
5. {% block title %}{% if form.instance.pk %}Edit Post{% else %}New Post{% endif %} - {{ block.super }}{% endblock %}
7. {% block content %}
8.     <h1>{% if form.instance.pk %}Edit Post{% else %}New Post{% endif %}</h1>
9.    
10.     <form method="post" enctype="multipart/form-data">
11.         {% csrf_token %}
12.         <div class="form-group">
13.             <label for="{{ form.title.id_for_label }}">Title</label>
14.             {{ form.title.errors }}
15.             <input type="text" class="form-control" name="{{ form.title.name }}" id="{{ form.title.id_for_label }}" value="{{ form.title.value|default:'' }}" required>
16.         </div>
17.         
18.         <div class="form-group">
19.             <label for="{{ form.slug.id_for_label }}">Slug</label>
20.             {{ form.slug.errors }}
21.             <input type="text" class="form-control" name="{{ form.slug.name }}" id="{{ form.slug.id_for_label }}" value="{{ form.slug.value|default:'' }}" required>
22.         </div>
23.         
24.         <div class="form-group">
25.             <label for="{{ form.content.id_for_label }}">Content</label>
26.             {{ form.content.errors }}
27.             <textarea class="form-control" name="{{ form.content.name }}" id="{{ form.content.id_for_label }}" rows="10" required>{{ form.content.value|default:'' }}</textarea>
28.         </div>
29.         
30.         <div class="form-group">
31.             <label for="{{ form.featured_image.id_for_label }}">Featured Image</label>
32.             {{ form.featured_image.errors }}
33.             <input type="file" class="form-control-file" name="{{ form.featured_image.name }}" id="{{ form.featured_image.id_for_label }}">
34.             {% if form.instance.featured_image %}
35.                 <img src="{{ form.instance.featured_image.url }}" class="img-thumbnail mt-2" alt="{{ form.instance.title }}">
36.             {% endif %}
37.         </div>
38.         
39.         <div class="form-group">
40.             <label for="{{ form.status.id_for_label }}">Status</label>
41.             {{ form.status.errors }}
42.             <select class="form-control" name="{{ form.status.name }}" id="{{ form.status.id_for_label }}">
43.                 {% for value, label in form.status.field.choices %}
44.                     <option value="{{ value }}" {% if form.status.value == value %}selected{% endif %}>{{ label }}</option>
45.                 {% endfor %}
46.             </select>
47.         </div>
48.         
49.         <div class="form-group">
50.             <label for="{{ form.categories.id_for_label }}">Categories</label>
51.             {{ form.categories.errors }}
52.             <select multiple class="form-control" name="{{ form.categories.name }}" id="{{ form.categories.id_for_label }}" size="5">
53.                 {% for category in form.categories.field.queryset %}
54.                     <option value="{{ category.id }}" {% if category.id in form.categories.value %}selected{% endif %}>{{ category.name }}</option>
55.                 {% endfor %}
56.             </select>
57.             <small class="form-text text-muted">Hold Ctrl (or Cmd on Mac) to select multiple categories.</small>
58.         </div>
59.         
60.         <div class="form-group">
61.             <label for="{{ form.tags.id_for_label }}">Tags</label>
62.             {{ form.tags.errors }}
63.             <select multiple class="form-control" name="{{ form.tags.name }}" id="{{ form.tags.id_for_label }}" size="5">
64.                 {% for tag in form.tags.field.queryset %}
65.                     <option value="{{ tag.id }}" {% if tag.id in form.tags.value %}selected{% endif %}>{{ tag.name }}</option>
66.                 {% endfor %}
67.             </select>
68.             <small class="form-text text-muted">Hold Ctrl (or Cmd on Mac) to select multiple tags.</small>
69.         </div>
70.         
71.         <button type="submit" class="btn btn-primary">Save</button>
72.         <a href="{% url 'blog:post_list' %}" class="btn btn-secondary">Cancel</a>
73.     </form>
74. {% endblock %}

复制代码

5. 视图函数

5.1 基本视图

在blog/views.py中创建视图函数：

2. # blog/views.py
3. from django.shortcuts import render, get_object_or_404, redirect
4. from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
5. from django.views.generic import ListView, DetailView, CreateView, UpdateView, DeleteView
6. from django.contrib.auth.mixins import LoginRequiredMixin, UserPassesTestMixin
7. from django.urls import reverse_lazy
8. from django.db.models import Count
9. from .models import Post, Category, Tag, Comment
10. from .forms import PostForm, CommentForm
12. class PostListView(ListView):
13.     model = Post
14.     template_name = 'blog/post_list.html'
15.     context_object_name = 'posts'
16.     paginate_by = 5
17.    
18.     def get_queryset(self):
19.         return Post.objects.filter(status='published')
20.    
21.     def get_context_data(self, **kwargs):
22.         context = super().get_context_data(**kwargs)
23.         context['categories'] = Category.objects.all()
24.         context['tags'] = Tag.objects.all()
25.         return context
27. class PostDetailView(DetailView):
28.     model = Post
29.     template_name = 'blog/post_detail.html'
30.     context_object_name = 'post'
31.    
32.     def get_context_data(self, **kwargs):
33.         context = super().get_context_data(**kwargs)
34.         context['categories'] = Category.objects.all()
35.         context['tags'] = Tag.objects.all()
36.         return context
38. class PostCreateView(LoginRequiredMixin, CreateView):
39.     model = Post
40.     form_class = PostForm
41.     template_name = 'blog/post_form.html'
42.    
43.     def form_valid(self, form):
44.         form.instance.author = self.request.user
45.         return super().form_valid(form)
47. class PostUpdateView(LoginRequiredMixin, UserPassesTestMixin, UpdateView):
48.     model = Post
49.     form_class = PostForm
50.     template_name = 'blog/post_form.html'
51.    
52.     def test_func(self):
53.         post = self.get_object()
54.         return self.request.user == post.author
56. class PostDeleteView(LoginRequiredMixin, UserPassesTestMixin, DeleteView):
57.     model = Post
58.     template_name = 'blog/post_confirm_delete.html'
59.     success_url = reverse_lazy('blog:post_list')
60.    
61.     def test_func(self):
62.         post = self.get_object()
63.         return self.request.user == post.author
65. def post_list_by_category(request, category_slug):
66.     category = get_object_or_404(Category, slug=category_slug)
67.     posts = Post.objects.filter(status='published', categories=category)
68.    
69.     paginator = Paginator(posts, 5)
70.     page = request.GET.get('page')
71.    
72.     try:
73.         posts = paginator.page(page)
74.     except PageNotAnInteger:
75.         posts = paginator.page(1)
76.     except EmptyPage:
77.         posts = paginator.page(paginator.num_pages)
78.    
79.     categories = Category.objects.all()
80.     tags = Tag.objects.all()
81.    
82.     return render(request, 'blog/post_list.html', {
83.         'posts': posts,
84.         'category': category,
85.         'categories': categories,
86.         'tags': tags,
87.         'is_paginated': True,
88.         'page_obj': posts,
89.     })
91. def post_list_by_tag(request, tag_slug):
92.     tag = get_object_or_404(Tag, slug=tag_slug)
93.     posts = Post.objects.filter(status='published', tags=tag)
94.    
95.     paginator = Paginator(posts, 5)
96.     page = request.GET.get('page')
97.    
98.     try:
99.         posts = paginator.page(page)
100.     except PageNotAnInteger:
101.         posts = paginator.page(1)
102.     except EmptyPage:
103.         posts = paginator.page(paginator.num_pages)
104.    
105.     categories = Category.objects.all()
106.     tags = Tag.objects.all()
107.    
108.     return render(request, 'blog/post_list.html', {
109.         'posts': posts,
110.         'tag': tag,
111.         'categories': categories,
112.         'tags': tags,
113.         'is_paginated': True,
114.         'page_obj': posts,
115.     })
117. def add_comment(request, post_id):
118.     post = get_object_or_404(Post, id=post_id)
119.    
120.     if request.method == 'POST':
121.         name = request.POST.get('name')
122.         email = request.POST.get('email')
123.         content = request.POST.get('content')
124.         
125.         if name and email and content:
126.             comment = Comment(
127.                 post=post,
128.                 name=name,
129.                 email=email,
130.                 content=content
131.             )
132.             comment.save()
133.    
134.     return redirect('blog:post_detail', pk=post.id)

复制代码

5.2 表单类

在blog目录下创建forms.py文件：

2. # blog/forms.py
3. from django import forms
4. from .models import Post, Comment
6. class PostForm(forms.ModelForm):
7.     class Meta:
8.         model = Post
9.         fields = ['title', 'slug', 'content', 'featured_image', 'status', 'categories', 'tags']
10.         
11.     def __init__(self, *args, **kwargs):
12.         super().__init__(*args, **kwargs)
13.         self.fields['categories'].widget.attrs.update({'size': '5'})
14.         self.fields['tags'].widget.attrs.update({'size': '5'})
16. class CommentForm(forms.ModelForm):
17.     class Meta:
18.         model = Comment
19.         fields = ['name', 'email', 'content']

复制代码

5.3 URL配置

在blog目录下创建urls.py文件：

2. # blog/urls.py
3. from django.urls import path
4. from . import views
6. app_name = 'blog'
8. urlpatterns = [
9.     path('', views.PostListView.as_view(), name='post_list'),
10.     path('post/<int:pk>/', views.PostDetailView.as_view(), name='post_detail'),
11.     path('post/new/', views.PostCreateView.as_view(), name='post_create'),
12.     path('post/<int:pk>/edit/', views.PostUpdateView.as_view(), name='post_update'),
13.     path('post/<int:pk>/delete/', views.PostDeleteView.as_view(), name='post_delete'),
14.     path('category/<slug:category_slug>/', views.post_list_by_category, name='post_list_by_category'),
15.     path('tag/<slug:tag_slug>/', views.post_list_by_tag, name='post_list_by_tag'),
16.     path('post/<int:post_id>/comment/', views.add_comment, name='add_comment'),
17. ]

复制代码

5.4 项目URL配置

更新项目的urls.py文件：

2. # myproject/urls.py
3. from django.contrib import admin
4. from django.urls import path, include
5. from django.conf import settings
6. from django.conf.urls.static import static
8. urlpatterns = [
9.     path('admin/', admin.site.urls),
10.     path('', include('blog.urls')),
11. ]
13. if settings.DEBUG:
14.     urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

复制代码

6. 高级功能

6.1 搜索功能

在blog/views.py中添加搜索视图：

2. # blog/views.py
3. from django.db.models import Q
5. def search(request):
6.     query = request.GET.get('q')
7.     posts = Post.objects.filter(status='published')
8.    
9.     if query:
10.         posts = posts.filter(
11.             Q(title__icontains=query) |
12.             Q(content__icontains=query) |
13.             Q(categories__name__icontains=query) |
14.             Q(tags__name__icontains=query)
15.         ).distinct()
16.    
17.     paginator = Paginator(posts, 5)
18.     page = request.GET.get('page')
19.    
20.     try:
21.         posts = paginator.page(page)
22.     except PageNotAnInteger:
23.         posts = paginator.page(1)
24.     except EmptyPage:
25.         posts = paginator.page(paginator.num_pages)
26.    
27.     categories = Category.objects.all()
28.     tags = Tag.objects.all()
29.    
30.     return render(request, 'blog/post_list.html', {
31.         'posts': posts,
32.         'query': query,
33.         'categories': categories,
34.         'tags': tags,
35.         'is_paginated': True,
36.         'page_obj': posts,
37.     })

复制代码

在blog/urls.py中添加搜索URL：

2. # blog/urls.py
3. urlpatterns = [
4.     # ... 其他URL
5.     path('search/', views.search, name='search'),
6. ]

复制代码

在基础模板中添加搜索表单：

2. <!-- 在base.html的navbar中添加 -->
3. <form class="form-inline my-2 my-lg-0" action="{% url 'blog:search' %}" method="get">
4.     <input class="form-control mr-sm-2" type="search" name="q" placeholder="Search" aria-label="Search">
5.     <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
6. </form>

复制代码

6.2 RSS订阅

在blog目录下创建feeds.py文件：

2. # blog/feeds.py
3. from django.contrib.syndication.views import Feed
4. from django.urls import reverse
5. from django.utils.feedgenerator import Rss201rev2Feed
6. from .models import Post
8. class LatestPostsFeed(Feed):
9.     feed_type = Rss201rev2Feed
10.     title = "My Blog"
11.     link = "/blog/"
12.     description = "Latest posts from My Blog"
13.    
14.     def items(self):
15.         return Post.objects.filter(status='published')[:10]
16.    
17.     def item_title(self, item):
18.         return item.title
19.    
20.     def item_description(self, item):
21.         return item.content[:200] + "..."
22.    
23.     def item_link(self, item):
24.         return reverse('blog:post_detail', args=[item.pk])
25.    
26.     def item_pubdate(self, item):
27.         return item.created_at

复制代码

在blog/urls.py中添加RSS订阅URL：

2. # blog/urls.py
3. from django.urls import path
4. from . import views
5. from .feeds import LatestPostsFeed
7. app_name = 'blog'
9. urlpatterns = [
10.     # ... 其他URL
11.     path('feed/', LatestPostsFeed(), name='post_feed'),
12. ]

复制代码

在基础模板中添加RSS链接：

2. <!-- 在base.html的head部分添加 -->
3. <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="{% url 'blog:post_feed' %}">

复制代码

6.3 站点地图

在blog目录下创建sitemaps.py文件：

2. # blog/sitemaps.py
3. from django.contrib.sitemaps import Sitemap
4. from django.urls import reverse
5. from .models import Post, Category, Tag
7. class PostSitemap(Sitemap):
8.     changefreq = "weekly"
9.     priority = 0.9
10.    
11.     def items(self):
12.         return Post.objects.filter(status='published')
13.    
14.     def lastmod(self, obj):
15.         return obj.updated_at
16.    
17.     def location(self, obj):
18.         return reverse('blog:post_detail', args=[obj.pk])
20. class CategorySitemap(Sitemap):
21.     changefreq = "monthly"
22.     priority = 0.7
23.    
24.     def items(self):
25.         return Category.objects.all()
26.    
27.     def location(self, obj):
28.         return reverse('blog:post_list_by_category', args=[obj.slug])
30. class TagSitemap(Sitemap):
31.     changefreq = "monthly"
32.     priority = 0.6
33.    
34.     def items(self):
35.         return Tag.objects.all()
36.    
37.     def location(self, obj):
38.         return reverse('blog:post_list_by_tag', args=[obj.slug])
40. class StaticViewSitemap(Sitemap):
41.     priority = 0.5
42.     changefreq = 'monthly'
43.    
44.     def items(self):
45.         return ['blog:post_list']
46.    
47.     def location(self, item):
48.         return reverse(item)

复制代码

在项目的urls.py中添加站点地图URL：

2. # myproject/urls.py
3. from django.contrib import admin
4. from django.urls import path, include
5. from django.contrib.sitemaps.views import sitemap
6. from blog.sitemaps import PostSitemap, CategorySitemap, TagSitemap, StaticViewSitemap
8. sitemaps = {
9.     'posts': PostSitemap,
10.     'categories': CategorySitemap,
11.     'tags': TagSitemap,
12.     'static': StaticViewSitemap,
13. }
15. urlpatterns = [
16.     path('admin/', admin.site.urls),
17.     path('', include('blog.urls')),
18.     path('sitemap.xml', sitemap, {'sitemaps': sitemaps}, name='django.contrib.sitemaps.views.sitemap'),
19. ]

复制代码

7. 测试

7.1 模型测试

在blog/tests.py中编写模型测试：

2. # blog/tests.py
3. from django.test import TestCase
4. from django.contrib.auth.models import User
5. from .models import Post, Category, Tag, Comment
7. class CategoryModelTest(TestCase):
8.     def setUp(self):
9.         self.category = Category.objects.create(
10.             name="Test Category",
11.             slug="test-category",
12.             description="Test category description"
13.         )
14.    
15.     def test_category_creation(self):
16.         self.assertEqual(self.category.name, "Test Category")
17.         self.assertEqual(self.category.slug, "test-category")
18.         self.assertEqual(self.category.description, "Test category description")
19.         self.assertEqual(str(self.category), "Test Category")
21. class TagModelTest(TestCase):
22.     def setUp(self):
23.         self.tag = Tag.objects.create(
24.             name="Test Tag",
25.             slug="test-tag"
26.         )
27.    
28.     def test_tag_creation(self):
29.         self.assertEqual(self.tag.name, "Test Tag")
30.         self.assertEqual(self.tag.slug, "test-tag")
31.         self.assertEqual(str(self.tag), "Test Tag")
33. class PostModelTest(TestCase):
34.     def setUp(self):
35.         self.user = User.objects.create_user(
36.             username='testuser',
37.             email='test@example.com',
38.             password='testpass123'
39.         )
40.         self.category = Category.objects.create(
41.             name="Test Category",
42.             slug="test-category"
43.         )
44.         self.tag = Tag.objects.create(
45.             name="Test Tag",
46.             slug="test-tag"
47.         )
48.         self.post = Post.objects.create(
49.             title="Test Post",
50.             slug="test-post",
51.             author=self.user,
52.             content="This is a test post content.",
53.             status="published"
54.         )
55.         self.post.categories.add(self.category)
56.         self.post.tags.add(self.tag)
57.    
58.     def test_post_creation(self):
59.         self.assertEqual(self.post.title, "Test Post")
60.         self.assertEqual(self.post.slug, "test-post")
61.         self.assertEqual(self.post.author, self.user)
62.         self.assertEqual(self.post.content, "This is a test post content.")
63.         self.assertEqual(self.post.status, "published")
64.         self.assertEqual(str(self.post), "Test Post")
65.         self.assertIn(self.category, self.post.categories.all())
66.         self.assertIn(self.tag, self.post.tags.all())
68. class CommentModelTest(TestCase):
69.     def setUp(self):
70.         self.user = User.objects.create_user(
71.             username='testuser',
72.             email='test@example.com',
73.             password='testpass123'
74.         )
75.         self.post = Post.objects.create(
76.             title="Test Post",
77.             slug="test-post",
78.             author=self.user,
79.             content="This is a test post content.",
80.             status="published"
81.         )
82.         self.comment = Comment.objects.create(
83.             post=self.post,
84.             name="Test Commenter",
85.             email="commenter@example.com",
86.             content="This is a test comment."
87.         )
88.    
89.     def test_comment_creation(self):
90.         self.assertEqual(self.comment.post, self.post)
91.         self.assertEqual(self.comment.name, "Test Commenter")
92.         self.assertEqual(self.comment.email, "commenter@example.com")
93.         self.assertEqual(self.comment.content, "This is a test comment.")
94.         self.assertTrue(self.comment.approved)
95.         self.assertEqual(str(self.comment), 'Comment by Test Commenter on Test Post')

复制代码

7.2 视图测试

继续在blog/tests.py中添加视图测试：

2. # blog/tests.py (继续)
3. from django.test import Client
4. from django.urls import reverse
6. class PostListViewTest(TestCase):
7.     def setUp(self):
8.         self.client = Client()
9.         self.user = User.objects.create_user(
10.             username='testuser',
11.             email='test@example.com',
12.             password='testpass123'
13.         )
14.         self.category = Category.objects.create(
15.             name="Test Category",
16.             slug="test-category"
17.         )
18.         self.tag = Tag.objects.create(
19.             name="Test Tag",
20.             slug="test-tag"
21.         )
22.         # Create 10 published posts
23.         for i in range(10):
24.             Post.objects.create(
25.                 title=f"Test Post {i}",
26.                 slug=f"test-post-{i}",
27.                 author=self.user,
28.                 content=f"This is test post {i} content.",
29.                 status="published"
30.             )
31.         # Create 2 draft posts
32.         for i in range(2):
33.             Post.objects.create(
34.                 title=f"Draft Post {i}",
35.                 slug=f"draft-post-{i}",
36.                 author=self.user,
37.                 content=f"This is draft post {i} content.",
38.                 status="draft"
39.             )
40.    
41.     def test_view_url_exists_at_desired_location(self):
42.         response = self.client.get('')
43.         self.assertEqual(response.status_code, 200)
44.    
45.     def test_view_url_accessible_by_name(self):
46.         response = self.client.get(reverse('blog:post_list'))
47.         self.assertEqual(response.status_code, 200)
48.    
49.     def test_view_uses_correct_template(self):
50.         response = self.client.get(reverse('blog:post_list'))
51.         self.assertEqual(response.status_code, 200)
52.         self.assertTemplateUsed(response, 'blog/post_list.html')
53.    
54.     def test_pagination_is_five(self):
55.         response = self.client.get(reverse('blog:post_list'))
56.         self.assertEqual(response.status_code, 200)
57.         self.assertTrue('is_paginated' in response.context)
58.         self.assertTrue(response.context['is_paginated'] == True)
59.         self.assertEqual(len(response.context['posts']), 5)
60.    
61.     def test_lists_all_posts(self):
62.         # Get second page and confirm it has (exactly) remaining 5 items
63.         response = self.client.get(reverse('blog:post_list') + '?page=2')
64.         self.assertEqual(response.status_code, 200)
65.         self.assertTrue('is_paginated' in response.context)
66.         self.assertTrue(response.context['is_paginated'] == True)
67.         self.assertEqual(len(response.context['posts']), 5)
68.    
69.     def test_only_published_posts(self):
70.         response = self.client.get(reverse('blog:post_list'))
71.         self.assertEqual(response.status_code, 200)
72.         self.assertEqual(len(response.context['posts']), 5)
73.         for post in response.context['posts']:
74.             self.assertEqual(post.status, 'published')
76. class PostDetailViewTest(TestCase):
77.     def setUp(self):
78.         self.client = Client()
79.         self.user = User.objects.create_user(
80.             username='testuser',
81.             email='test@example.com',
82.             password='testpass123'
83.         )
84.         self.post = Post.objects.create(
85.             title="Test Post",
86.             slug="test-post",
87.             author=self.user,
88.             content="This is a test post content.",
89.             status="published"
90.         )
91.    
92.     def test_view_url_exists_at_desired_location(self):
93.         response = self.client.get(f'/post/{self.post.pk}/')
94.         self.assertEqual(response.status_code, 200)
95.    
96.     def test_view_url_accessible_by_name(self):
97.         response = self.client.get(reverse('blog:post_detail', kwargs={'pk': self.post.pk}))
98.         self.assertEqual(response.status_code, 200)
99.    
100.     def test_view_uses_correct_template(self):
101.         response = self.client.get(reverse('blog:post_detail', kwargs={'pk': self.post.pk}))
102.         self.assertEqual(response.status_code, 200)
103.         self.assertTemplateUsed(response, 'blog/post_detail.html')
104.    
105.     def test_nonexistent_post(self):
106.         response = self.client.get(reverse('blog:post_detail', kwargs={'pk': 999}))
107.         self.assertEqual(response.status_code, 404)
109. class PostCreateViewTest(TestCase):
110.     def setUp(self):
111.         self.client = Client()
112.         self.user = User.objects.create_user(
113.             username='testuser',
114.             email='test@example.com',
115.             password='testpass123'
116.         )
117.         self.category = Category.objects.create(
118.             name="Test Category",
119.             slug="test-category"
120.         )
121.         self.tag = Tag.objects.create(
122.             name="Test Tag",
123.             slug="test-tag"
124.         )
125.    
126.     def test_redirect_if_not_logged_in(self):
127.         response = self.client.get(reverse('blog:post_create'))
128.         self.assertRedirects(response, '/accounts/login/?next=/post/new/')
129.    
130.     def test_logged_in_uses_correct_template(self):
131.         self.client.login(username='testuser', password='testpass123')
132.         response = self.client.get(reverse('blog:post_create'))
133.         self.assertEqual(response.status_code, 200)
134.         self.assertTemplateUsed(response, 'blog/post_form.html')
135.    
136.     def test_create_post(self):
137.         self.client.login(username='testuser', password='testpass123')
138.         response = self.client.post(reverse('blog:post_create'), {
139.             'title': 'New Test Post',
140.             'slug': 'new-test-post',
141.             'content': 'This is a new test post content.',
142.             'status': 'published',
143.             'categories': [self.category.id],
144.             'tags': [self.tag.id]
145.         })
146.         self.assertEqual(response.status_code, 302)
147.         self.assertTrue(Post.objects.filter(title='New Test Post').exists())
148.         new_post = Post.objects.get(title='New Test Post')
149.         self.assertEqual(new_post.author, self.user)
150.         self.assertIn(self.category, new_post.categories.all())
151.         self.assertIn(self.tag, new_post.tags.all())

复制代码

7.3 运行测试

运行测试以验证代码的正确性：

2. # 运行所有测试
3. python manage.py test
5. # 运行特定应用的测试
6. python manage.py test blog
8. # 运行特定测试类
9. python manage.py test blog.tests.PostModelTest
11. # 运行特定测试方法
12. python manage.py test blog.tests.PostModelTest.test_post_creation

复制代码

8. 部署上线

8.1 生产环境配置

创建生产环境设置文件myproject/settings_production.py：

2. # myproject/settings_production.py
3. from .settings import *
5. # Security settings
6. DEBUG = False
7. ALLOWED_HOSTS = ['yourdomain.com', 'www.yourdomain.com']
9. # Database settings (using PostgreSQL as an example)
10. DATABASES = {
11.     'default': {
12.         'ENGINE': 'django.db.backends.postgresql',
13.         'NAME': 'mydatabase',
14.         'USER': 'mydatabaseuser',
15.         'PASSWORD': 'mypassword',
16.         'HOST': 'localhost',
17.         'PORT': '5432',
18.     }
19. }
21. # Static files settings
22. STATIC_ROOT = '/var/www/myproject/static/'
23. MEDIA_ROOT = '/var/www/myproject/media/'
25. # Security settings
26. SECURE_SSL_REDIRECT = True
27. SESSION_COOKIE_SECURE = True
28. CSRF_COOKIE_SECURE = True
29. SECURE_BROWSER_XSS_FILTER = True
30. SECURE_CONTENT_TYPE_NOSNIFF = True
31. X_FRAME_OPTIONS = 'DENY'
33. # Email settings
34. EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
35. EMAIL_HOST = 'smtp.yourdomain.com'
36. EMAIL_PORT = 587
37. EMAIL_USE_TLS = True
38. EMAIL_HOST_USER = 'your_email@yourdomain.com'
39. EMAIL_HOST_PASSWORD = 'your_email_password'
40. DEFAULT_FROM_EMAIL = 'your_email@yourdomain.com'
42. # Logging settings
43. LOGGING = {
44.     'version': 1,
45.     'disable_existing_loggers': False,
46.     'handlers': {
47.         'file': {
48.             'level': 'ERROR',
49.             'class': 'logging.FileHandler',
50.             'filename': '/var/log/django/error.log',
51.         },
52.     },
53.     'loggers': {
54.         'django': {
55.             'handlers': ['file'],
56.             'level': 'ERROR',
57.             'propagate': True,
58.         },
59.     },
60. }

复制代码

8.2 收集静态文件

在部署前，收集所有静态文件到一个目录：

2. # 设置环境变量
3. export DJANGO_SETTINGS_MODULE=myproject.settings_production
5. # 收集静态文件
6. python manage.py collectstatic

复制代码

8.3 服务器配置

2. # 更新系统
3. sudo apt update
4. sudo apt upgrade
6. # 安装Python和pip
7. sudo apt install python3 python3-pip python3-venv
9. # 安装PostgreSQL
10. sudo apt install postgresql postgresql-contrib
12. # 安装Nginx
13. sudo apt install nginx
15. # 安装Gunicorn
16. pip install gunicorn

复制代码

2. # 切换到PostgreSQL用户
3. sudo -u postgres psql
5. # 创建数据库和用户
6. CREATE DATABASE mydatabase;
7. CREATE USER mydatabaseuser WITH PASSWORD 'mypassword';
8. ALTER ROLE mydatabaseuser SET client_encoding TO 'utf8';
9. ALTER ROLE mydatabaseuser SET default_transaction_isolation TO 'read committed';
10. ALTER ROLE mydatabaseuser SET timezone TO 'UTC';
11. GRANT ALL PRIVILEGES ON DATABASE mydatabase TO mydatabaseuser;
12. \q

复制代码

创建Gunicorn服务文件/etc/systemd/system/gunicorn.service：

2. [Unit]
3. Description=gunicorn daemon
4. After=network.target
6. [Service]
7. User=www-data
8. Group=www-data
9. WorkingDirectory=/var/www/myproject
10. ExecStart=/var/www/myproject/venv/bin/gunicorn --access-logfile - --workers 3 --bind unix:/run/gunicorn.sock myproject.wsgi:application
12. [Install]
13. WantedBy=multi-user.target

复制代码

启动Gunicorn服务：

2. # 启动Gunicorn服务
3. sudo systemctl start gunicorn
4. sudo systemctl enable gunicorn
6. # 检查服务状态
7. sudo systemctl status gunicorn

复制代码

创建Nginx配置文件/etc/nginx/sites-available/myproject：

2. server {
3.     listen 80;
4.     server_name yourdomain.com www.yourdomain.com;
6.     location = /favicon.ico { access_log off; log_not_found off; }
7.     location /static/ {
8.         root /var/www/myproject;
9.     }
10.     location /media/ {
11.         root /var/www/myproject;
12.     }
14.     location / {
15.         include proxy_params;
16.         proxy_pass http://unix:/run/gunicorn.sock;
17.     }
18. }

复制代码

启用配置并重启Nginx：

2. # 启用站点
3. sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled/
5. # 测试Nginx配置
6. sudo nginx -t
8. # 重启Nginx
9. sudo systemctl restart nginx

复制代码

8.4 SSL证书配置

使用Let’s Encrypt获取SSL证书：

2. # 安装Certbot
3. sudo apt install certbot python3-certbot-nginx
5. # 获取SSL证书
6. sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com
8. # 测试自动续期
9. sudo certbot renew --dry-run

复制代码

8.5 部署流程

创建部署脚本deploy.sh：

2. #!/bin/bash
4. # Variables
5. PROJECT_DIR="/var/www/myproject"
6. VENV_DIR="$PROJECT_DIR/venv"
7. SERVICE_NAME="gunicorn"
8. NGINX_SITES="/etc/nginx/sites-available"
10. # Pull latest changes
11. cd $PROJECT_DIR
12. git pull origin main
14. # Activate virtual environment
15. source $VENV_DIR/bin/activate
17. # Install dependencies
18. pip install -r requirements.txt
20. # Run migrations
21. python manage.py migrate --settings=myproject.settings_production
23. # Collect static files
24. python manage.py collectstatic --noinput --settings=myproject.settings_production
26. # Restart Gunicorn
27. sudo systemctl restart $SERVICE_NAME
29. # Restart Nginx
30. sudo systemctl restart nginx
32. echo "Deployment completed successfully!"

复制代码

使脚本可执行并运行：

2. chmod +x deploy.sh
3. ./deploy.sh

复制代码

9. 总结与展望

本教程详细介绍了从环境搭建到部署上线的完整Django项目开发流程。我们学习了如何：

1. 搭建Django开发环境
2. 创建和配置Django项目与应用
3. 设计数据库模型并进行迁移
4. 创建模板和静态文件
5. 编写视图函数和URL配置
6. 实现高级功能如搜索、RSS订阅和站点地图
7. 编写测试确保代码质量
8. 部署项目到生产环境

9.1 进一步学习的方向

如果您想继续深入学习Django，可以考虑以下方向：

1. Django REST Framework：构建RESTful API
2. Django Channels：实现WebSocket和实时功能
3. Celery：处理异步任务和定时任务
4. Docker：容器化Django应用
5. CI/CD：自动化测试和部署流程

9.2 最佳实践

在Django开发中，遵循以下最佳实践：

1. 保持代码整洁：遵循PEP 8风格指南
2. 使用版本控制：使用Git管理代码
3. 编写测试：确保代码质量和功能正确性
4. 文档化：为代码和项目编写文档
5. 安全性：遵循Django安全最佳实践
6. 性能优化：优化查询和缓存策略

9.3 结语

Django是一个功能强大且灵活的Web框架，适合构建各种规模的Web应用。通过本教程的学习，您应该已经掌握了Django开发的基本技能和流程。继续实践和探索，您将能够构建更加复杂和功能丰富的Web应用。

祝您在Django开发之旅中取得成功！