当前位置：首页 > news >正文

Django 实战总结：手把手教你搭建个人博客

news 2026/6/11 21:47:22

Django 是 Python 世界中最重量级的 Web 框架。它的核心哲学是 DRY (Don't Repeat Yourself)，即“不要重复造轮子”。

在这篇文章中，我们将通过搭建一个个人博客系统，来总结 Django 开发中最常用的核心方法和流程。

核心架构：MTV 模式

在开始写代码前，必须理解 Django 的设计模式 MTV：

M (Model): 数据存取层。负责定义数据库结构（表、字段）。

T (Template): 表现层。负责把数据渲染成 HTML 页面给用户看。

V (View): 业务逻辑层。负责接收请求、读取数据、调用模板、返回响应。

简单来说：用户访问 -> View 接收 -> 找 Model拿数据 -> 塞进 Template -> 返回给用户。

环境搭建与项目初始化

这是 Django 开发的起手式。

常用命令

1. 安装 Django

pip install django

2. 创建新项目 (Project) - 比如叫 myblog

django-admin startproject myblog

3. 进入目录

cd myblog

4. 创建一个应用 (App) - 比如叫 blog

python manage.py startapp blog

关键点：创建 App 后，一定要去 settings.py 的 INSTALLED_APPS 列表里注册它！

myblog/settings.py

INSTALLED_APPS = [
...
'blog', # 注册我们的应用
]

第一步：定义数据 (Models)

博客最核心的数据就是“文章”。我们需要在数据库里建一张表。在 Django 中，我们只需要写一个 Python 类。

blog/models.py

from django.db import models
from django.contrib.auth.models import User # 导入内置的用户模型

class Post(models.Model):
# 标题：字符字段，最大长度200
title = models.CharField(max_length=200)

# 作者：外键关联到 User 表
author = models.ForeignKey(User, on_delete=models.CASCADE)# 正文：文本字段，不限长度
body = models.TextField()# 创建时间：自动设置为当前时间
created_at = models.DateTimeField(auto_now_add=True)def __str__(self):return self.title  # 这样在后台显示的不仅是 Object，而是文章标题

常用操作：数据库迁移
每当修改了 models.py，都必须执行以下两条命令来同步数据库：

python manage.py makemigrations # 生成迁移文件（记录你的修改）
python manage.py migrate # 执行迁移（真正修改数据库）

第二步：后台管理 (Admin)

Django 最强大的功能之一就是自带后台。我们只需要几行代码，就能拥有一个功能完备的文章管理系统。

blog/admin.py

from django.contrib import admin
from .models import Post

admin.site.register(Post)

现在，创建一个管理员账号：

python manage.py createsuperuser

运行服务 python manage.py runserver，访问 http://127.0.0.1:8000/admin，你就可以在网页上发布文章了！

第三步：处理逻辑 (Views)

我们现在需要两个页面：

首页：列出所有文章。

详情页：查看单篇文章内容。

blog/views.py

from django.shortcuts import render, get_object_or_404
from .models import Post

1. 首页视图

def post_list(request):
# ORM 查询：获取所有文章，并按时间倒序排列
posts = Post.objects.all().order_by('-created_at')
# render 方法：渲染模板，并把 context 数据传过去
return render(request, 'blog/post_list.html', {'posts': posts})

2. 详情页视图

def post_detail(request, pk):
# 获取指定 ID (pk) 的文章，如果不存在则返回 404 错误
post = get_object_or_404(Post, pk=pk)
return render(request, 'blog/post_detail.html', {'post': post})

关键方法总结：

Post.objects.all(): 获取所有数据。

Post.objects.filter(...): 筛选数据。

get_object_or_404: 安全地获取单个对象。

render: 将数据和 HTML 模板结合并返回。

第四步：配置路由 (URLs)

我们需要告诉 Django，当用户访问什么网址时，调用哪个 View。

myblog/urls.py (主路由)

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

urlpatterns = [
path('admin/', admin.site.urls),
path('', include('blog.urls')), # 将根路径转发给 blog 应用
]

blog/urls.py (App 路由 - 需新建)

from django.urls import path
from . import views

urlpatterns = [
# 首页：访问空路径 '' 时，调用 views.post_list
path('', views.post_list, name='post_list'),

# 详情页：访问 post/数字 时，调用 views.post_detail
# <int:pk> 是路径转换器，会把 URL 中的数字捕获并传给 view 函数的 pk 参数
path('post/<int:pk>/', views.post_detail, name='post_detail'),

]

第五步：编写页面 (Templates)

最后，我们需要写 HTML 来展示数据。Django 使用其特有的模板语言 (DTL)。

blog/templates/blog/post_list.html

我的博客

最新文章

<!-- 模板标签：循环遍历 posts 列表 -->
{% for post in posts %}<div><!-- URL 标签：根据 name 生成链接，不用硬编码 URL --><h2><a href="{% url 'post_detail' pk=post.pk %}">{{ post.title }}</a></h2><p>作者: {{ post.author }} | 时间: {{ post.created_at }}</p><p>{{ post.body|truncatewords:30 }}</p> <!-- 过滤器：只显示前30个词 --></div><hr>
{% endfor %}

blog/templates/blog/post_detail.html

发布于: {{ post.created_at }}

返回首页