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

开篇：什么是Django，它能用来做什么？

在互联网的世界里，网站是我们每天都会接触的东西。比如购物网站、社交平台、新闻站点等。而这些网站背后都有一个强大的“大脑”在支撑——那就是后端系统。
如果你对写代码感兴趣，并希望学习如何构建自己的网站，那么 Django 是一个非常棒的起点。

那么，Django 是什么？

Django 是一个用 Python 编写的 Web框架（Web Framework）。你可以把它想象成一套工具箱，帮助你更快速、安全地开发功能齐全的网站。它自带了很多有用的功能，比如：

• 数据库操作（用于存储用户信息、文章内容等）
• 用户认证（登录和注册）
• 后台管理界面
• URL路由控制
• 模板引擎（网页显示）

最重要的是，Django 设计的理念是：“Don't Repeat Yourself（DRY）”，意思是你不需要重复做同一件事，框架会帮你完成很多底层工作，你可以专注于实现网站的功能。

---

环境准备：安装与配置开发环境

在我们开始编写我们的第一个网站之前，我们需要先准备好开发环境。这一部分我们将详细讲解：

1. 安装 Python
2. 安装 pip 工具
3. 安装 Django
4. 创建项目目录

📝 提示：以下操作适用于 Windows、Mac 和 Linux 系统，如遇不同请特别说明。

步骤 1：安装 Python

首先，你需要确保你的电脑上已经安装了 Python。

✅ 检查是否安装过 Python：

打开终端（Mac/Linux）或命令提示符（Windows），输入：

python --version

如果出现类似 Python 3.9.6 的版本号，说明已经安装好了。

如果没有输出或者报错，请到官网 https://www.python.org 下载安装最新版 Python（推荐 Python 3.8 以上）。

⚠️ 注意：安装时务必勾选 Add to PATH，否则后续可能找不到 Python 命令。

---

步骤 2：安装 pip

pip 是 Python 的包管理工具，可以帮助我们安装第三方模块，例如 Django。

检查 pip 是否安装好：

pip --version

如果有版本号就说明已安装成功。如果没有，执行下面的命令安装：

python -m ensurepip --upgrade

---

步骤 3：安装 Django

使用 pip 安装 Django：

pip install django

安装完成后检查一下是否安装成功：

django-admin --version

你应该看到 Django 的版本号，比如 4.2.1 或者更高。

---

步骤 4：创建项目文件夹

接下来我们要为我们的网站建立一个新的项目目录。

mkdir mysite
cd mysite

这个文件夹就是我们整个项目的根目录。

---

核心概念：Django 中的关键术语通俗解释

在正式动手之前，我们来了解一下 Django 中的几个核心概念。不用担心它们听起来很复杂，我会用最简单的语言为你解释。

名词	通俗解释
项目 Project	就是一个完整的网站工程，包含多个小程序
应用 App	是项目中可独立运行的小程序，比如“博客模块”、“用户中心”等
模型 Model	相当于数据库中的表格，用于存储数据
视图 View	接收请求，处理数据并返回页面或数据
模板 Template	网页的内容模板，决定网页怎么展示
URL 路由	类似地图的导航，告诉浏览器访问哪个地址应该执行哪段代码

现在你不需要完全理解这些定义也没关系，随着实践你会逐步掌握。

---

实战项目：创建你的第一个网站！

现在我们来一步步搭建一个简单的网站，名字叫做 "Hello Django"。

第一步：创建 Django 项目

在你刚刚创建的 mysite 文件夹中，运行下面的命令：

django-admin startproject hello_django .

这会在当前目录下生成一个名为 hello_django 的项目结构，包括以下几个文件：

mysite/
├── manage.py                # 管理项目的脚本
└── hello_django/            # 项目配置文件夹
    ├── __init__.py          # 空文件，表示这是一个Python包
    ├── settings.py          # 整个项目的设置文件
    ├── urls.py              # URL 路由配置表
    └── wsgi.py              # WSGI服务器配置

第二步：启动开发服务器

Django 自带了一个轻量级的本地开发服务器，我们可以用它测试我们的网站。

运行如下命令：

python manage.py runserver

然后打开浏览器访问：http://127.0.0.1:8000

如果看到 “It worked!” 页面，说明你的网站已经启动成功！

🎉 我们已经完成了第一步！

第三步：创建一个应用

Django 鼓励把网站拆分成多个App（应用）。每个应用负责一个小功能。

我们现在创建一个名叫 pages 的应用，用于存放基本页面逻辑：

python manage.py startapp pages

创建后的结构如下：

mysite/
├── pages/                     # 新建的应用目录
│   ├── migrations/
│   ├── __init__.py
│   ├── admin.py
│   ├── apps.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── manage.py
└── hello_django/

但此时 Django 还不知道这个新应用的存在，所以我们需要手动将它注册进项目中。

打开 hello_django/settings.py 文件，在 INSTALLED_APPS 列表中添加 'pages',：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'pages',  # 添加这一行
]

保存文件即可。

---

第四步：定义第一个页面视图

我们打算做一个主页（首页），显示一句话：欢迎来到我的第一个Django网站！

打开 pages/views.py 文件，编辑为以下内容：

from django.http import HttpResponse

def home(request):
    return HttpResponse("欢迎来到我的第一个Django网站！")

这段代码的意思是：当你访问这个页面的时候，会返回一句欢迎语。

---

第五步：配置 URL 路由

接下来我们需要告诉 Django，访问哪个网址对应哪个视图函数。

步骤一：编辑 pages 应用的 urls.py 文件

在 pages 文件夹下新建一个文件叫 urls.py，内容如下：

from django.urls import path
from . import views

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

这里我们设置了空路径 '' 对应 views.home 函数，也就是我们的首页。

步骤二：连接主项目的 url 文件

现在要让整个项目知道这个新的 URL 配置。

打开 hello_django/urls.py，修改如下：

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

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('pages.urls')),  # 添加这行
]

这表示：访问网站根路径 / 时，由 pages.urls 来处理。

---

第六步：再次运行服务器查看效果

再次运行服务器：

python manage.py runserver

刷新浏览器 http://127.0.0.1:8000，你会看到：

欢迎来到我的第一个Django网站！

🎉恭喜你，成功完成了你的第一个 Django 页面！

---

常见问题解答

刚开始学 Django 的时候，难免会遇到一些小问题。下面是几个常见的新手问题和对应的解决方法：

Q1：安装 Django 报错怎么办？

• 可能是网络问题导致下载失败：可以尝试换源安装：

  pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 权限不足问题（特别是 macOS / Linux）：加上 sudo 再试一次：

  sudo pip install django
  

Q2：运行 runserver 的时候说 “端口已被占用”

这是由于 8000 端口已经被别的程序占用了。可以改用其他端口号：

python manage.py runserver 8001

然后访问 http://127.0.0.1:8001

Q3：修改了代码但没有生效？

• 确保你保存了修改的文件。
• 如果是在运行服务器过程中修改的，服务器一般会自动重启，但有时候需要手动 Ctrl+C 停止再重新运行。

Q4：运行页面时提示“No module named ‘pages’”

说明你没有正确注册 app，记得回到 settings.py 的 INSTALLED_APPS 里添加 'pages'。

---

学习建议：下一步该学什么？

恭喜你完成了 Django 入门的第一步！你现在不仅可以运行简单的网页，还掌握了 Django 的基础结构和流程。

接下来你可以继续学习以下内容，让你的网站变得真正可用：

✅ 进阶技能推荐

学习方向	推荐主题
数据库模型	学习 Model，创建文章、用户等数据库表
模板系统	使用 HTML 模板美化页面
用户注册与登录	学习 Auth 认证机制
表单处理	接收用户输入并验证
CSS & Bootstrap	美化前端样式
部署上线	学习如何将网站部署到公网服务器

---

结语：坚持练习才能成长

编程这件事，最重要的不是一开始就什么都懂，而是愿意一步一步去动手尝试。每一个优秀的程序员，都是从“Hello World”起步的。

今天的教程中，我们一起完成了：

• 安装 Django 环境
• 创建第一个项目和应用
• 编写简单页面并配置访问路径

希望你能够自己动手跟着做一遍，并尝试自己扩展，比如写一个关于我、联系我的页面等等。有问题欢迎留言交流，祝你早日成为 Django 高手！

如果你喜欢这样的教程，欢迎持续关注，接下来我们会深入讲解更多实用的内容，比如如何用 Django 搭建一个博客系统！

---

作者：拥有十年后端开发经验的资深讲师
欢迎留言交流、纠错或提问