Django入门教程：搭建你的第一个Python网站

Go语言浪人

2025-06-14 16:27

阅读 346

什么是Django，它能用来做什么？

Django 是一个基于 Python 的Web开发框架，它的目标是让开发者能够更快、更轻松地构建功能齐全的网站。你可以把 Django 想象成一套“工具包”，它已经为你准备好了许多常用的 Web 功能，比如管理用户登录、数据库交互、页面路由等，让你不用从头开始搭建所有东西。

在实际应用中，Django 被广泛用于创建各种类型的网站和系统，例如博客平台、电商网站、内容管理系统（CMS）、社交网络平台等。很多大型网站，如 Instagram 和 Pinterest，都是使用 Django 构建的。这得益于 Django 的稳定性、安全性和强大的社区支持。

学习 Django 将使你能够在短时间内上手构建复杂的 Web 应用。对于初学者来说，Django 是进入 Web 开发领域的理想选择，因为它不仅提供了简单易用的 API，还通过丰富的文档和教程降低了学习门槛。无论你是想成为一名专业的后端开发人员，还是希望打造自己的个人项目，Django 都是一个值得学习的强大工具。

接下来我们将一步步带你从零开始搭建第一个属于自己的网站！

环境准备：安装 Python 和 Django

要开始使用 Django，我们首先需要准备好开发环境。这里我们将逐步介绍如何安装 Python 和 Django，并确保它们正常运行。整个过程非常简单，即使你是编程新手也能顺利完成。

第一步：安装 Python

Django 是基于 Python 的框架，所以首先我们需要安装 Python。目前最推荐使用的是 Python 3.x 版本。

访问 Python 官方网站
根据你的操作系统（Windows 或 macOS）下载最新的稳定版本安装程序（一般会自动识别并显示适合你的系统的下载链接）。
双击下载的安装文件进行安装。
- 在 Windows 上，务必勾选 “Add Python to PATH”，这样可以在命令行中直接使用 Python。
- 在 macOS 上，安装完成后可以通过终端执行 python3 --version 来检查是否安装成功。

安装完成后，打开终端（macOS）或命令提示符（Windows），输入以下命令查看 Python 是否安装成功：

python --version

如果你看到类似 Python 3.x.x 的输出，说明 Python 已经正确安装。

第二步：安装 Django

Python 安装完成后，我们可以使用 Python 自带的包管理器 pip 来安装 Django。

在终端或命令提示符中执行以下命令来安装最新版本的 Django：

pip install django

这个过程可能需要一些时间，取决于你的网络速度。如果一切顺利，你会看到类似 Successfully installed django-x.x.x 的信息。

验证 Django 是否安装成功的方法是检查其版本号。输入以下命令：

django-admin --version

如果你看到了类似 4.x.x 的版本号，就说明 Django 已经安装完成。

常见问题解答

Q: 安装 pip 时提示错误怎么办？
A: 如果你的计算机没有安装 pip，可以尝试使用如下命令单独安装：

python -m ensurepip --upgrade

然后再次尝试安装 Django。

Q: 安装 Django 时提示权限不足？
A: 在某些操作系统上，可能需要添加 --user 参数，或者使用管理员权限运行命令：

pip install --user django

如果是 Linux 或 macOS 用户，可以尝试使用 sudo 命令：

sudo pip install django

完成这些步骤之后，你的开发环境就已经准备好了！现在，我们就可以正式开始 Django 的学习之旅了！

Django 的核心概念：快速理解关键术语

为了更好地使用 Django 构建网站，你需要了解几个核心概念。虽然这些术语听起来有点专业，但其实它们的作用都非常直观，就像搭积木一样帮助你组织整个网站。下面我们会逐一解释每个概念，并用简单的例子说明它们的用途。

1. 项目（Project）

项目的含义：
Django 中的“项目”代表整个网站的整体结构。它可以看作是存放所有配置和应用程序的主容器。一个项目通常包含多个应用程序（App）。

举个例子：
假设我们要创建一个博客网站，那么整个博客就是一个项目。在这个项目里，可能会有不同的模块，比如文章列表页、后台管理页、评论功能等。每一个模块都可以是一个独立的应用程序。

怎么操作：
我们稍后将通过 Django 提供的命令 django-admin startproject mysite 创建一个名为 mysite 的项目。

2. 应用程序（App）

应用程序的意义：
“应用程序”是用来处理特定功能的部分。一个项目可以包含多个应用程序，每个应用程序专注于一项任务。

举个例子：
继续以博客为例，我们可以为文章写一个专门的应用程序，比如叫 blogapp，另外还可以有一个用于管理用户信息的应用程序，叫做 user_profile。

怎么操作：
在一个 Django 项目中，我们可以使用命令 python manage.py startapp blogapp 创建一个新的应用程序，并将它注册到项目的配置文件中。

3. 模型（Model）

模型的作用：
模型是 Django 中用来定义数据结构的组件，相当于数据库表的蓝图。每个模型都会自动对应到数据库中的表格。

举个例子：
在博客网站中，一篇文章可以包含标题、正文和发布时间。我们可以为“文章”创建一个模型，告诉 Django 这些字段的具体类型和要求。代码示例如下：

from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    pub_date = models.DateTimeField('date published')

这段代码定义了一个名为 Article 的模型，包含了三个字段：标题、正文和发布日期。

4. 视图（View）

视图的功能：
视图负责处理用户的请求，并决定向用户展示什么内容。它是连接数据库（模型）与页面（模板）的重要桥梁。

举个例子：
比如当用户访问 /articles/ 页面时，我们可能希望他们看到所有的文章列表。这个时候就需要编写一个视图函数来获取所有文章的信息，并将其传递给前端页面。代码示例如下：

from django.shortcuts import render
from .models import Article

def article_list(request):
    articles = Article.objects.all()
    return render(request, 'article_list.html', {'articles': articles})

上述代码通过调用模型 Article 获取所有文章，并将结果渲染到模板文件 article_list.html 中。

5. 模板（Template）

模板的角色：
模板负责页面的外观，即最终用户看到的 HTML 内容。它允许动态填充数据，从而避免重复编写静态代码。

举个例子：
如果我们想在网页上显示所有文章的标题和正文，可以编写一个 HTML 模板，像这样：

<!DOCTYPE html>
<html>
<head>
    <title>文章列表</title>
</head>
<body>
    <h1>文章列表</h1>
    {% for article in articles %}
        <h2>{{ article.title }}</h2>
        <p>{{ article.content }}</p>
    {% endfor %}
</body>
</html>

这段代码通过 {% for %} 循环和 {{ }} 表达式，动态展示每篇文章的内容。

6. URL 配置（URLConf）

URL 配置的意义：
URL 配置决定了不同网址应该映射到哪个视图。换句话说，它是网站的导航地图，告诉用户访问某个网址时能看到什么内容。

举个例子：
假设我们希望当用户访问 /articles/ 时，看到文章列表页面。我们可以在 urls.py 文件中进行如下配置：

from django.urls import path
from . import views

urlpatterns = [
    path('articles/', views.article_list, name='article_list'),
]

这样一来，当你访问 http://yourwebsite.com/articles/ 时，就会触发 article_list 函数，显示对应的文章内容。

通过这些基本概念，你可以开始理解 Django 是如何分工协作的。项目是总指挥，应用程序是具体的任务单元，模型存储数据，视图控制逻辑，模板生成界面，URL 配置则是通往各个页面的路线图。把这些部分组合起来，就能构建出一个完整的网站了！

实战项目：用 Django 创建一个简易的博客网站

现在，让我们动手实践一下吧！我们将一步步教你创建一个简单的博客网站。你将会学到如何建立项目、创建应用程序、设计数据模型、编写视图、设置模板以及配置 URL，让整个网站跑起来。

第一步：创建 Django 项目

打开终端或命令提示符。
执行以下命令创建一个新的 Django 项目：

django-admin startproject myblog

cd myblog

查看目录结构，你会看到如下文件：

myblog/
    manage.py
    myblog/
        __init__.py
        settings.py
        urls.py
        wsgi.py

其中：

manage.py 是管理项目的脚本；
myblog/settings.py 是项目的核心配置文件；
myblog/urls.py 是项目的 URL 配置。

第二步：创建 Django 应用程序

在终端中执行以下命令，创建一个新的应用程序 blogapp：

python manage.py startapp blogapp

打开 myblog/settings.py 文件，在 INSTALLED_APPS 中添加 'blogapp'，让 Django 认识这个新创建的应用程序：

INSTALLED_APPS = [
    ...
    'blogapp',
]

保存文件后，Django 会知道我们要使用 blogapp 这个应用程序。

第三步：设计数据模型

接下来，我们需要设计博客文章的数据模型。打开 blogapp/models.py 文件，输入以下代码：

from django.db import models

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

    def __str__(self):
        return self.title

这段代码定义了一个名为 Post 的模型，包含文章标题（title）、内容（content）和发布时间（pub_date）这三个字段。__str__ 方法的作用是在管理界面中以文章标题作为显示名称。

保存后，执行以下命令来创建数据库表：

python manage.py makemigrations blogapp
python manage.py migrate

这两条命令会让 Django 把模型的变化反映到数据库中。

第四步：注册模型到后台管理

为了让管理员可以直接管理我们的文章，我们可以把模型注册到 Django 的后台管理系统。

打开 blogapp/admin.py 文件，修改代码如下：

from django.contrib import admin
from .models import Post

admin.site.register(Post)

接下来创建管理员账户：

python manage.py createsuperuser

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

启动服务器：

python manage.py runserver

浏览器中访问 http://localhost:8000/admin，用刚才创建的账号登录。你将看到一个管理界面，里面已经包含了我们刚刚注册的 Post 模型。你可以在这里新增文章、编辑文章、删除文章等内容。

第五步：编写视图

接下来，我们需要编写视图函数来处理网页请求。打开 blogapp/views.py 文件，输入以下代码：

from django.shortcuts import render
from .models import Post

def post_list(request):
    posts = Post.objects.all().order_by('-pub_date')
    return render(request, 'post_list.html', {'posts': posts})

这是一个名为 post_list 的视图函数，它从数据库中获取所有文章，并按照发布时间降序排列，最后通过 render 函数传递给模板 post_list.html。

第六步：创建模板

在 blogapp 目录下新建一个文件夹 templates，然后在 templates 文件夹中新建一个文件 post_list.html。
打开 post_list.html，输入以下 HTML 内容：

<!DOCTYPE html>
<html>
<head>
    <title>博客文章列表</title>
</head>
<body>
    <h1>博客文章列表</h1>
    {% for post in posts %}
        <h2>{{ post.title }}</h2>
        <p>{{ post.content }}</p>
        <small>发布时间：{{ post.pub_date }}</small>
        <hr/>
    {% endfor %}
</body>
</html>

这段代码使用了 Django 的模板语言，通过 {% for %} 循环展示了所有文章的标题、内容和发布时间。

第七步：配置 URL

最后，我们需要设置 URL 映射，让用户能够访问到我们写的页面。

打开 blogapp 目录下的 urls.py 文件（如果没有，请手动创建），输入以下代码：

from django.urls import path
from . import views

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

这段代码设置了空路径 ' '（也就是根目录），让它指向 post_list 视图。

接下来，我们需要更新项目的 URL 配置。打开 myblog/urls.py 文件，修改代码如下：

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

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

这里添加了 path('', include('blogapp.urls'))，这意味着当我们访问网站的根目录时，Django 会查找 blogapp.urls 中的匹配规则。

保存所有文件，重新启动服务器：

python manage.py runserver

然后，访问 http://localhost:8000，你应该会看到一个博客文章列表页面，上面显示了你在后台管理中添加的所有文章。恭喜你，你的第一个 Django 博客网站成功上线啦！

通过以上步骤，你已经完成了项目创建、数据库模型设计、后台管理配置、视图编写、模板创建以及 URL 设置。尽管这是一个简单的博客网站，但它涵盖了 Django 开发的基本流程。随着学习的深入，你可以不断拓展功能，比如添加单篇文章详情页面、用户评论功能等。尽情探索吧！

新手常见问题及解决方案

在使用 Django 学习过程中，新手可能会遇到一些典型的问题。以下是一些常见问题及其解决方法，帮助你快速排查和修复错误。

1. 数据库迁移失败

问题描述：
执行 makemigrations 或 migrate 命令时出现错误，无法正确更新数据库表结构。

解决方法：

确保模型文件（models.py）中没有语法错误，比如拼写错误或未导入模块。
如果之前运行过迁移但失败了，可以尝试删除相关的迁移文件（在 migrations 文件夹下），然后重新运行 makemigrations 和 migrate。
如果数据库出现问题（例如 SQLite 的锁问题），可以尝试停止服务器并重启后再执行迁移。

2. 模板找不到

问题描述：
当运行网站时，提示类似 "TemplateDoesNotExist at /" 或找不到模板文件的错误。

解决方法：

确认模板文件所在的路径是否正确。Django 默认会在每个应用的 templates 文件夹下寻找模板。
检查模板文件名是否与视图中引用的一致，例如 render(request, 'template_name.html', context) 中的名称是否准确。
可以通过调整 settings.py 中的 TEMPLATES 配置，检查模板搜索路径是否有误。

3. URL 匹配失败

问题描述：
访问某个页面时，提示 “Page not found (404)” 错误，可能是 URL 配置不正确导致的。

解决方法：

检查 urls.py 文件中是否有正确的路径配置。确保路径字符串与访问的地址完全匹配。
确认视图函数是否存在，并且拼写无误。
如果使用了正则表达式或动态路径参数，请检查格式是否正确。

4. 其他报错建议

阅读错误日志： 当 Django 报错时，终端或浏览器中会显示详细的错误信息，包括错误发生的具体位置和原因。耐心阅读这些信息可以帮助你快速定位问题。
查阅官方文档： Django 的官方文档非常详细，几乎所有问题都能找到对应的解释和示例。
使用搜索引擎： 大多数常见的 Django 问题都有人遇到过，直接搜索错误信息通常能找到答案。
加入社区交流： 如果实在找不到解决办法，可以去 Stack Overflow、Django 中文社区等论坛提问，通常都会有热心网友帮你解答。

通过熟悉这些问题和解决方式，相信你很快就能掌握调试 Django 项目的技巧，少走弯路！

下一步的学习路径建议

恭喜你完成了 Django 的入门教程！现在你已经掌握了创建简单网站的基本技能，但这只是 Django 强大功能的冰山一角。为了进一步提升你的开发能力，以下是几个值得深入学习的方向：

1. 学习更多 Django 高级功能

表单处理（Forms）： Django 提供了一套强大的表单系统，用于处理用户提交的数据。你可以学习如何创建自定义表单、进行数据验证，并将表单与数据库模型结合使用。
身份认证系统（Authentication）： Django 自带了完善的用户管理功能，包括用户注册、登录、注销以及权限控制。了解这部分知识可以帮助你实现会员制网站、后台管理系统等功能。
RESTful API 开发： 使用 Django REST Framework（DRF

标签:工具产品Go前端

最热最新

暂无评论

为你推荐

暂无相关推荐

Django入门教程：搭建你的第一个Python网站

什么是Django，它能用来做什么？

环境准备：安装 Python 和 Django

第一步：安装 Python

第二步：安装 Django

常见问题解答

Django 的核心概念：快速理解关键术语

1. 项目（Project）

2. 应用程序（App）

3. 模型（Model）

4. 视图（View）

5. 模板（Template）

6. URL 配置（URLConf）

实战项目：用 Django 创建一个简易的博客网站

第一步：创建 Django 项目

第二步：创建 Django 应用程序

第三步：设计数据模型

第四步：注册模型到后台管理

第五步：编写视图

第六步：创建模板

第七步：配置 URL

新手常见问题及解决方案

1. 数据库迁移失败

2. 模板找不到

3. URL 匹配失败

4. 其他报错建议

下一步的学习路径建议

1. 学习更多 Django 高级功能

评论 0

为你推荐

精选内容