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

一、开篇：Django是什么？用来做什么？

在互联网的世界里，网站是我们最熟悉的伙伴之一。你正在看的这篇文章，可能就是通过一个用某种技术构建的网站来呈现的。而今天我们要介绍的 Django，就是一个帮助我们快速搭建网站的强大工具。

Django 是一个基于 Python 编写的 Web开发框架（Web Framework）。简单来说，它就像是一套已经设计好的“积木”，我们可以利用这些“积木”快速地搭出自己的网站。

使用 Django 的好处很多：

• 它让开发者专注于编写核心功能，而不是重复的基础工作；
• 内置了用户认证、数据库管理、表单处理等常用功能；
• 遵循“开箱即用”的理念，适合快速开发；
• 社区活跃，文档丰富，学习资源多。

无论你是想做一个个人博客、电商网站，还是企业内部系统，Django 都是一个非常不错的选择。

接下来，我们就一步步带你从零开始，搭建你的第一个 Django 网站！

---

二、环境准备：搭建开发环境

要开始使用 Django，你需要先安装一些必要的软件和库。不用担心，下面我们会一步步告诉你怎么做，即使你是完全的新手也能轻松完成。

1. 安装 Python

Django 是基于 Python 的，所以第一步就是安装 Python。

Windows 用户操作步骤：

1. 打开浏览器访问 Python官网；
2. 点击 “Downloads” —> “Download Python 3.x”；
3. 下载完成后双击运行安装程序；
4. 勾选“Add to PATH”选项，然后点击 Install Now；
5. 安装完成后，在命令提示符（CMD）中输入以下命令验证是否安装成功：

   python --version
   

Mac/Linux 用户：

通常已经预装了 Python，但推荐安装最新版以兼容性更好。可以用 Homebrew（Mac）或 apt-get（Linux）安装 Python。

2. 创建虚拟环境（建议）

为了避免不同项目之间的依赖冲突，我们推荐使用虚拟环境。

python -m venv myenv

激活虚拟环境：

• Windows：

  myenv\Scripts\activate
  

• Mac/Linux：

  source myenv/bin/activate
  

激活后，终端前缀通常会变成 (myenv)，表示当前处于虚拟环境中。

3. 安装 Django

现在我们就可以安装 Django 了。在终端中输入：

pip install django

验证安装是否成功：

django-admin --version

如果你看到类似 4.2.1 这样的版本号，恭喜你，环境已经准备好了！

---

三、Django 核心概念解析

在正式开始写代码之前，我们需要了解几个基本的概念。别担心，我会尽量用通俗的语言来解释它们。

1. 项目（Project）

你可以把“项目”理解为整个网站的大框架。比如你要做一个博客网站，这个博客网站本身就是一个 Django 项目。

项目里包含了全局的配置信息，比如数据库连接、静态文件路径等。

2. 应用（App）

在一个项目里，可以有多个应用。你可以把它想象成网站的不同模块。

例如，在一个学校管理系统中，学生管理、教师管理、成绩查询可以分别作为三个不同的应用。

3. URL路由（URL Routing）

当你在浏览器中输入网址时，Django 就是通过 URL 来决定该显示哪个页面。URL 路由就像地图上的路线导航一样，告诉 Django 哪个地址对应哪个内容。

4. 视图（View）

视图是用来处理网页请求的函数或类。你可以把它理解成一个“工人”，负责接收用户的请求，并返回对应的网页内容。

5. 模板（Template）

模板就是 HTML 文件，它决定了网页长什么样子。Django 允许你在 HTML 中插入变量和逻辑，这样网页就能根据不同的数据动态变化。

6. 模型（Model）

模型是用来描述数据库结构的。你可以把它理解成一张表格的设计图，比如用户表、文章表等。Django 提供了 ORM（对象关系映射），让你用 Python 的方式操作数据库，而不需要直接写 SQL。

---

四、实战项目：创建第一个 Django 网站

现在我们来一步步创建我们的第一个 Django 网站——一个简单的“欢迎页面”。

第一步：创建项目

在终端中执行以下命令：

django-admin startproject mysite

这会在当前目录下生成一个名为 mysite 的文件夹，里面是项目的初始文件。

进入项目文件夹：

cd mysite

此时你可以看到如下结构：

mysite/
├── manage.py         # 项目管理脚本
└── mysite/           # 主配置文件夹
    ├── __init__.py
    ├── settings.py   # 项目设置
    ├── urls.py       # URL配置
    └── wsgi.py

第二步：启动开发服务器

Django 自带了一个轻量级的开发服务器，非常适合本地调试。

在终端中输入：

python manage.py runserver

你会看到类似这样的输出：

Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

打开浏览器，访问 http://127.0.0.1:8000，你应该能看到 Django 默认的欢迎页面。

第三步：创建第一个应用（App）

让我们来创建一个叫 pages 的应用。

执行命令：

python manage.py startapp pages

你会看到项目目录里多了个 pages/ 文件夹。

为了让 Django 认识这个新应用，我们需要将它添加到项目的 settings.py 中的 INSTALLED_APPS 列表中。

打开 mysite/settings.py，找到这一行：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

在最后加入 'pages'：

INSTALLED_APPS = [
    ...
    'pages',
]

第四步：定义第一个视图（View）

打开 pages/views.py 文件，写入以下代码：

from django.http import HttpResponse

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

第五步：配置 URL 路由

为了让用户能通过网址访问这个视图，我们需要配置 URL 路由。

首先，在 pages/ 目录下新建一个文件叫 urls.py，内容如下：

from django.urls import path
from . import views

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

然后，打开主项目的 urls.py 文件（位于 mysite/urls.py），修改内容如下：

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

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

这样就把 pages 应用中的 URL 配置包含进来了。

第六步：刷新网站看看效果

回到终端，按下 Ctrl + C 停止当前服务器，再重新运行：

python manage.py runserver

刷新网页 http://127.0.0.1:8000，现在你应该会看到：

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

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

---

五、新手常见问题解答

在学习过程中，你可能会遇到一些问题，下面是几个常见的疑问和解答：

❓ Q1：安装 Django 报错怎么办？

A1： 可能是因为 pip 或 Python 没有正确安装。请检查 Python 是否成功安装，可以用 python --version 查看版本。另外，尝试使用管理员权限运行安装命令。

❓ Q2：manage.py 找不到怎么办？

A2： 确保你已经进入了正确的项目目录。每个 Django 项目都有一个 manage.py 文件，如果找不到，请确认你是否真的创建了项目。

❓ Q3：为什么网站改了代码没生效？

A3： 开发服务器默认不会自动重启。修改代码后，手动停止服务（Ctrl+C），然后重新运行 runserver 即可。

❓ Q4：出现 "Error loading MySQLdb module" 错误？

A4： 如果你没有使用 MySQL 数据库，可以忽略这个错误。这是因为在某些操作系统中，默认需要安装 MySQL 支持包。

---

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

你现在有了基础，接下来可以沿着以下几个方向继续学习：

✅ 1. 学习模板系统（Templates）

目前我们只是返回了一段文字，实际网站中更多是 HTML 页面。Django 提供了强大的模板引擎来支持动态网页的渲染。

你可以尝试在 pages 应用中创建 templates/pages/ 文件夹，并使用 .html 模板来渲染更漂亮的页面。

✅ 2. 学习模型（Models）与数据库操作

Django 的 ORM 功能非常强大，学会模型之后你可以轻松操作数据库，实现用户注册、文章发布等功能。

✅ 3. 使用 Admin 后台管理系统

Django 提供了内置的后台管理系统，可以帮助你快速搭建后台页面。

你可以试试注册一个超级用户：

python manage.py createsuperuser

然后访问 /admin 页面登录查看。

✅ 4. 学习表单（Forms）

表单是网站与用户交互的重要部分。学会如何创建和处理表单，是你迈向中级开发者的必经之路。

---

总结

这篇教程我们从零开始介绍了 Django 的基本知识，搭建了开发环境，并动手实现了一个简单的欢迎页面。虽然只是一个开头，但你已经掌握了 Django 的基本运作方式。

记住：编程最重要的不是死记硬背，而是不断练习和思考。遇到不懂的地方不要怕，多查、多试、多练。

如果你觉得这篇教程对你有帮助，不妨试着自己再建一个 Django 项目，比如做个日记本、留言墙或者小商店。坚持下去，你就一定能成为优秀的 Python Web 开发者！

祝你学习愉快，码上成功 🚀！