用Django搭第一个网站：从零开始踩坑记

去年刚进公司的时候，我被安排接手一个小项目，是一个内部用的内容管理系统（CMS），用来管理产品手册、操作文档和FAQ。说小，是因为功能不多；但真正做起来才发现，作为初学者的我还是差点掉进很多“新手村”的大坑里。

今天就结合我当时的经验，分享一下我是怎么一步步用 Django 搭建起这个项目的，中间踩了哪些坑，最后又得到了什么收获。

---

背景故事：为什么选Django？

当时技术负责人问我要不要试试用 Django 来做这个 CMS？我心里有点虚，毕竟之前只是在书上看过一些概念，没写过完整的项目。不过他说：“Django 很适合中等规模的应用，开发效率高，结构清晰，你完全可以从小项目练手。”

于是我就开始了我的第一个正式的后端 Web 开发之旅。

这个系统的主要需求包括：

• 用户登录鉴权
• 内容分类展示
• 文章发布和编辑
• 标签管理和搜索功能
• 简单的权限控制（管理员/普通用户）

虽然看起来不复杂，但对刚上手的我来说，还是有不少细节需要注意。

---

技术方案选择与整体架构设计

Django 的优势之一就是自带 Admin 后台，这对内容管理系统来说简直是天赐良物。我决定采用以下基础架构：

project/
├── cms/
│   ├── settings.py
│   ├── urls.py
│   └── ...
├── articles/
│   ├── models.py
│   ├── views.py
│   └── templates/
├── users/
│   └── ...（用户相关模型和逻辑）
└── manage.py

每个 App 都独立解耦，比如 articles 负责文章内容，users 负责用户认证与权限。

数据库方面用了 PostgreSQL，生产环境部署时配合 Gunicorn + Nginx，静态文件走 CDN，这套组合现在也比较常见。

---

关键代码实践：核心模块实现思路

1. 创建应用并定义模型（models.py）

from django.db import models
from django.contrib.auth.models import User

class Category(models.Model):
    name = models.CharField(max_length=50, unique=True)

class Tag(models.Model):
    name = models.CharField(max_length=30, unique=True)

class Article(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    author = models.ForeignKey(User, on_delete=models.CASCADE)
    category = models.ForeignKey(Category, on_delete=models.SET_NULL, null=True)
    tags = models.ManyToManyField(Tag)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

    def __str__(self):
        return self.title

这里一个容易忽略的点是字段的索引优化。刚开始没加 db_index=True，后来发现当数据量上来以后，搜索变慢了，才补加上去。

2. 视图函数（views.py）

以首页文章列表为例：

from django.shortcuts import render
from .models import Article

def index(request):
    articles = Article.objects.select_related('category', 'author').prefetch_related('tags').all()
    return render(request, 'articles/index.html', {'articles': articles})

使用 select_related 和 prefetch_related 可以有效减少数据库查询次数，提升性能。

3. 模板渲染（index.html）

{% extends "base.html" %}
{% block content %}
<h1>所有文章</h1>
<ul>
  {% for article in articles %}
  <li>
    <a href="/articles/{{ article.id }}">{{ article.title }}</a>
    <small>{{ article.author }} | {{ article.created_at|date:"Y-m-d" }}</small>
    <p>{{ article.content|truncatewords:20 }}</p>
  </li>
  {% endfor %}
</ul>
{% endblock %}

模板部分要保持轻量，逻辑尽量放在视图层处理。

---

开发过程中的几个大坑和解决办法

坑一：用户认证流程搞不清楚

刚开始写登录页的时候，我直接写了个表单，POST 提交到后台自己验证用户名密码，然后用 session 存储状态……结果完全忽略了 Django 自带的 auth 模块！

后来才意识到，应该使用：

from django.contrib.auth import authenticate, login

user = authenticate(username=username, password=password)
if user:
    login(request, user)

再配合装饰器来限制访问权限：

from django.contrib.auth.decorators import login_required

@login_required
def edit_article(request, id):
    # 编辑逻辑

这不仅更安全，还节省了很多重复工作。

坑二：数据库迁移出错导致历史数据丢失

因为刚开始不懂得 makemigrations 和 migrate 的关系，有一次改完 model 直接跑 migrate，结果把数据库清空了……还好是在测试环境。

经验教训是：

• 修改 model 一定要先 makemigrations
• 迁移前务必备份数据库
• 使用第三方工具如 Django Extensions 的 graph 出 migration 图会更直观

坑三：上线后静态文件404

本地调试一切正常，但部署到服务器后，CSS 和 JS 文件一直加载失败。查了很久才发现原来在生产环境下，Django 是不会自动处理静态资源的。

解决方案很简单：

settings.py

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

然后运行：

python manage.py collectstatic

再配合 Nginx 对 /static/ 路径做代理即可。

---

实际效果与收益总结

经过大概一个月的开发时间，这个内部 CMS 正式上线，用户反馈良好。我们做了简单的性能压测，在 50 并发左右时响应时间稳定在 80ms 左右，基本满足预期。

有几个特别欣慰的地方：

• 利用 Django Admin 快速搭建起了后台管理系统
• 模块化设计让后续维护非常方便
• ORM 设计合理，后期扩展标签搜索等功能也很快

---

我的一些建议和注意事项

如果你是刚接触 Django 的朋友，以下几点建议可能会对你有帮助：

1. 优先看官方文档，别一开始就去看那些所谓“高级教程”，基础稳才是王道。
2. 多用内置的功能，比如 Admin、Auth、Form、Template 系统，它们不是鸡肋，而是真能提高效率。
3. 提前规划好 App 结构，避免后期拆分困难。
4. 数据库设计要谨慎，一旦上线就不能随便改字段类型或名称。
5. 开发阶段可以关闭 DEBUG=False，这样更容易提前发现问题。
6. 学点运维知识，比如 Nginx、Gunicorn、Supervisor、日志收集这些，在上线时真的很关键。

---

写在最后：框架只是工具，工程思维更重要

这一整套项目下来，我最大的感悟并不是学会了 Django 怎么写 view 或者 model，而是明白了：

“开发一个可用、可维护、可拓展的系统，远比写几行代码更重要。”

Django 给我们提供了一个非常好的起点，但它不能替我们做所有的决策。我们仍需认真思考接口设计、数据库范式、权限划分以及部署策略等问题。

希望这篇文章能帮到正在学习 Django 或准备动手做一个 Python 网站的你。一起加油！