Django 项目创建一个评论系统

2025 年 5 月 18 日 | 阅读 7 分钟

什么是 Django 框架？

Django 是一个基于 Python 的框架，可以帮助开发人员加速安全 Web 应用程序的生产，并有效地进行扩展。MVT 架构结构使 Django 能够提供开箱即用的功能，从而提高 Web 开发效率。

Django 的主要特点

快速开发：帮助开发人员快速构建应用程序。
安全性：防止 SQL 注入、CSRF、XSS 和点击劫持。
可扩展性：被 Instagram、Pinterest 和 Mozilla 等大型网站使用。
内置电池：附带 ORM、身份验证、管理面板等。

Django 架构：MVT (模型-视图-模板)

框架 Django 使用 MVT（模型-视图-模板）结构设计模型。

模型：定义数据库结构（例如，表、关系）。
视图：处理逻辑并与模型交互。
模板：向用户显示数据（HTML 文件）。

示例： 请求页面启动 Django 以检索模型数据，这些数据在视图中处理，然后发送到模板进行显示。

为什么要使用 Django？

内置管理面板 - 无需额外编码即可管理您的应用。
ORM（对象关系映射）- 使用 Python 而不是 SQL 与数据库交互。
身份验证系统 - 包括用户登录、注册和会话处理。
中间件支持 - 安全性、缓存和会话管理。
REST API 支持 - 使用 Django REST Framework (DRF) 轻松构建 API。

什么是评论系统？

评论系统是一种 Web 应用程序功能，允许用户发布评论和查看内容，并能够管理这些评论，特别是关于博客文章或社交媒体内容。该系统升级了用户参与度，因为它允许讨论并产生反馈，并允许用户互动。

评论系统的关键组件

用户管理
1. 允许用户注册、登录和评论。
2. 可以支持匿名或访客评论。
3. 可能包括带有头像和显示名称的用户资料。
评论模型和存储
1. 将评论存储在数据库中，其中包含用户、内容、时间戳和父级（用于回复）等字段。
2. 支持线程（嵌套）评论以允许回复。
评论提交和显示
1. 用户可以通过表单输入和提交评论。
2. 评论以结构化格式显示，通常按日期或受欢迎程度排序。
3. 可能包括 Markdown 支持、表情符号反应或媒体附件等功能。
审核和垃圾邮件防护
1. 管理员可以批准、编辑或删除评论。
2. 使用 CAPTCHA、Akismet 或基于 AI 的过滤器等工具进行自动垃圾邮件检测。
3. 黑名单或过滤冒犯性词语。
回复和线程系统
1. 用户可以回复现有评论。
2. 回复可能缩进或在视觉上区分。
喜欢和不喜欢系统（可选）
1. 用户可以对评论进行投票或反对。
2. 热门评论可能会被突出显示。
通知和提及
1. 用户在有人回复他们的评论时会收到通知。
2. 提及 (@用户名) 通知特定用户。
AJAX 或实时更新
1. 新评论无需刷新页面即可显示 (AJAX/WebSockets)。
2. 通过流畅的交互改善用户体验。
API 支持（如果需要）
1. REST API 端点允许移动应用程序或外部系统与评论系统交互。
2. 通常使用 Django REST Framework (DRF) 构建。
部署和安全
1. CSRF 保护，防止攻击。
2. 速率限制，阻止垃圾邮件和滥用。
3. 托管在服务器或云服务上，以便访问。

安装 Django 和设置虚拟环境

在开始之前，请确保您已安装 Python (3.x)。

创建虚拟环境

虚拟环境有助于管理依赖项并使您的项目隔离。在您的终端或命令提示符中运行以下命令

# Create a virtual environment
python -m venv venv  
# Activate the virtual environment
# Windows:
venv\Scripts\activate  
# macOS/Linux:
source venv/bin/activate

激活后，您的终端将在命令提示符前显示 (venv)，表示虚拟环境已激活。

安装 Django

使用虚拟环境激活后，使用以下命令安装 Django

通过检查 Django 版本来验证安装

创建一个新的 Django 项目

Django 项目是 Web 应用程序的主要容器。要创建一个，请运行

这将创建一个 myproject/ 文件夹，其结构如下

myproject/ │── manage.py # Command-line utility for Django 
│── myproject/ # Project settings and configuration 
│ │── init.py
│ │── settings.py # Project settings 
│ │── urls.py # URL routing 
│ │── asgi.py
│ └── wsgi.py

进入项目目录

运行开发服务器

您应该会看到如下输出

在 http://127.0.0.1:8000/ 启动开发服务器

在您的浏览器中打开 http://127.0.0.1:8000/，您应该会看到默认的 Django 欢迎页面。

设置一个 Django 应用用于评论

Django 应用是处理特定功能的模块，例如评论系统。通过运行以下命令创建一个名为“comments”的应用

这将创建一个 comments/ 文件夹，其结构如下

 
comments/ 
│── migrations/ # Database migrations 
│── init.py
│── admin.py # Admin panel integration 
│── apps.py
│── models.py # Database models (Comment model will be added here) 
│── tests.py
│── views.py # Handles request logic 

在设置中注册应用

打开 settings.py，并将“comments”添加到 INSTALLED_APPS 列表中

 
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'comments',  # Add this line
]

运行迁移

应用初始迁移

定义评论模型

在 comments/models.py 中，定义一个 Comment 模型

from django.db import models
from django.contrib.auth.models import User
class Comment(models.Model):
    user = models.ForeignKey(User, on_delete=models.CASCADE)  # Link to User model
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    parent = models.ForeignKey('self', null=True, blank=True, on_delete=models.CASCADE, related_name='replies')
    def __str__(self):
        return f"Comment by {self.user} on {self.created_at}"

运行迁移

python manage.py makemigrations comments
python manage.py migrate

在管理面板中注册模型

在 comments/admin.py 中

from django.contrib import admin
from .models import Comment
admin.site.register(Comment)

运行服务器并访问管理面板

python manage.py createsuperuser  # Create an admin user
python manage.py runserver

转到 http://127.0.0.1:8000/admin/ 并登录以管理评论。

Django Project to Create a Comments System

为评论创建视图

在 comments/views.py 中

from django.shortcuts import render, redirect
from .models import Comment
from django.contrib.auth.decorators import login_required
def comment_list(request):
    comments = Comment.objects.filter(parent__isnull=True).order_by('-created_at')
    return render(request, 'comments/comment_list.html', {'comments': comments})
@login_required
def add_comment(request):
    if request.method == 'POST':
        content = request.POST['content']
        parent_id = request.POST.get('parent_id')
        parent = Comment.objects.get(id=parent_id) if parent_id else None
        Comment.objects.create(user=request.user, content=content, parent=parent)
        return redirect('comment_list')
    return redirect('comment_list')

配置 URL

在 comments/urls.py 中

from django.urls import path
from .views import comment_list, add_comment
urlpatterns = [
    path('', comment_list, name='comment_list'),
    path('add/', add_comment, name='add_comment'),
]

在 comment_system/urls.py 中，包含 comments 应用

from django.contrib import admin
from django.urls import path, include
urlpatterns = [
    path('admin/', admin.site.urls),
    path('comments/', include('comments.urls')),  # Add this line
]

为评论创建模板

<!DOCTYPE html>
<html>
<head>
    <title>Comments System</title>
</head>
<body>
    <h2>Comments</h2>
    {% for comment in comments %}
        <p><strong>{{ comment.user.username }}</strong>: {{ comment.content }}</p>
        <form method="post" action="{% url 'add_comment' %}">
            {% csrf_token %}
            <input type="hidden" name="parent_id" value="{{ comment.id }}">
            <input type="text" name="content" placeholder="Reply...">
            <button type="submit">Reply</button>
        </form> 
        {% for reply in comment.replies.all %}
            <p style="margin-left:20px;"><strong>{{ reply.user.username }}</strong>: {{ reply.content }}</p>
        {% endfor %}
    {% endfor %}
    <h3>Add a Comment</h3>
    <form method="post" action="{% url 'add_comment' %}">
        {% csrf_token %}
        <input type="text" name="content" placeholder="Write a comment...">
        <button type="submit">Post</button>
    </form>
</body>
</html>

添加身份验证

要仅允许已登录的用户发布评论，请修改 comment_system/settings.py

LOGIN_URL = '/admin/login/'  # Redirect users to login if they are not authenticated

运行服务器并测试

启动服务器

访问 http://127.0.0.1:8000/comments/ 以发布和查看评论。

优点

使用内置功能快速开发： Django 的内置电池方法提供了开箱即用的身份验证、ORM 和管理面板。与从头开始构建所有内容相比，节省了开发时间。
默认安全： Django 提供了内置的安全功能，如 CSRF 保护、SQL 注入预防和 XSS 保护，使评论系统更安全。
可扩展性和性能： Django 的 ORM 允许高效的数据库查询。如果通过缓存和异步处理进行适当优化，则可以处理大规模应用程序。
灵活的用户身份验证： 支持内置的用户身份验证，用于已登录的用户。可以扩展以允许匿名/访客评论。
支持线程/嵌套评论： Django 的自引用 ForeignKey 能够轻松实现线程回复。
用于审核的 Django 管理面板： 管理员无需额外代码即可使用 Django 的内置管理面板管理评论。
与 Django REST Framework (DRF) 的 API 集成： 很容易转换为 REST API，以服务于移动应用程序或第三方集成。
AJAX 和实时支持： 通过 Django Channels 和 WebSockets，您可以在无需刷新页面的情况下实现实时评论。
自定义和可扩展性： Django 的模块化架构允许轻松自定义（例如，添加喜欢、编辑权限、过滤等）。

缺点

默认单体： Django 是一个单体框架，这意味着它可能不是基于微服务的应用程序的最佳选择。
数据库查询开销： 复杂的嵌套评论可能需要优化的查询（例如，使用 select_related() 或缓存以避免 N+1 查询问题）。
并非最轻量级的选项： 与 Flask 或 FastAPI 相比，对于只需要基本评论部分的小型应用程序，Django 可能会过度设计。
初学者学习曲线： Django 的 ORM、基于类的视图 (CBV) 和身份验证系统对于新开发人员来说可能让人不知所措。
大规模评论的性能瓶颈： 如果没有数据库索引、缓存 (Redis) 或分页，性能可能会随着数千条评论而下降。
AJAX 和实时更新需要额外的工作： 默认情况下，Django 不支持实时更新；您需要使用 AJAX、Django Channels 或 WebSockets。

应用

Django 评论系统可以集成到各种平台中，以增强用户交互和参与度。以下是一些实际应用

博客平台： 在线用户可以回复博客文章，并通过交互式讨论参与。示例：个人博客或新闻网站，读者可以在其中分享观点。
社交媒体和社区论坛： 允许用户评论帖子、回复他人并建立讨论。示例：Reddit 风格的论坛、问答网站或讨论板。
电子商务和产品评论： 客户可以留下评论和评价产品。示例：亚马逊等在线商店，用户可以在其中评论产品体验。
教育平台： 学生和讲师可以交流课程讨论，进行问题查询，并提供与学习相关的反馈，作为他们互动的一部分。 E-learning 平台 Udemy 和 Coursera 通过其平台内的讨论线程为学习者提供专门的讲座讨论线程。
视频流和娱乐网站： 观看者可以评论视频、系列剧或电影。示例：YouTube 风格的平台，用户可以在其中与内容进行互动。

结论

Django 评论系统为 Web 应用程序提供了灵活的架构，这些应用程序需要通过讨论功能生成用户生成的内容。开发过程变得更加高效，因为 Django 包含内置的身份验证功能以及 ORM 和管理面板，以及安全模块，从而消除了对额外第三方工具的需求。该系统允许管理评论以及身份验证功能以及适用于博客和论坛平台以及社交媒体环境的审核支持。

下一篇主题投票系统项目使用 Django 框架