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

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

如果你是刚刚接触编程或者Python的新手，可能会对“Django”这个词感到陌生。没关系，我们来简单介绍一下。

Django是一个用Python语言编写的Web框架。它的作用就是帮你快速搭建一个网站的后端部分（也就是负责处理数据和逻辑的部分），比如用户登录、文章发布、数据库管理等等。

你可以把Django想象成一个搭积木的工具箱。你不用从头开始造轮子，只需要按照规则使用这些现成的模块，就能很快地拼出一个功能完整的网站。

为什么选择Django学习网站开发？

• 上手简单：Django内置了很多功能（比如用户系统、后台管理等），不需要你自己写太多代码。
• 文档丰富：Django官方有非常详细的中文和英文文档，遇到问题容易查到答案。
• 适合初学者：语法清晰，结构统一，非常适合零基础的朋友入门。
• 就业热门技术：掌握Django后，可以从事后端开发或全栈开发的工作。

现在，我们就一起动手搭建一个最简单的Django网站吧！

---

环境准备：如何安装Django？

在正式开始前，你需要准备好一些必要的开发工具。

步骤1：安装Python

Django是用Python写的，所以第一步是要确保电脑上装好了Python。

如何检查是否已安装Python？

打开终端（Windows叫命令行，Mac/Linux叫Terminal）输入：

python --version

如果看到类似 Python 3.8.5 的字样，说明已经安装了。

如果没有安装，请去官网下载安装包： https://www.python.org/downloads/

安装时记得勾选 “Add Python to PATH”，这样就能方便地在任何地方运行Python命令。

步骤2：安装pip（Python包管理器）

pip是用来安装Python第三方库的工具，一般安装完Python之后就自带了。

验证方法：

pip --version

如果没有安装，请参考官方文档进行安装。

步骤3：安装Django

接下来，我们通过pip安装Django：

pip install django

这个过程可能需要几分钟，取决于网络速度。

安装完成后验证一下是否成功：

django-admin --version

如果输出了版本号（例如 4.2.0），说明安装成功！

---

核心概念：理解Django的基本结构

虽然你现在还不太懂这些名词，但为了后续开发更顺利，我们需要先了解几个基本概念。

1. 项目（Project）与应用（App）

• 项目（Project）：整个网站的大框架。比如你要做一个博客网站，这个博客的整体配置就放在Project里。
• 应用（App）：具体的业务模块。比如博客网站可以分成“用户管理App”、“文章展示App”、“评论App”等。

打个比方：Django项目就像一本书，而应用就是这本书中的不同章节。

2. 模型（Model）

用来定义你的网站数据结构。比如在博客系统中，“文章”这个模型可能包含标题、作者、发布时间等信息。

3. 视图（View）

视图决定网站“显示什么内容”。比如当你访问 /home 页面时，应该返回什么页面内容，就是由视图控制的。

4. 模板（Template）

模板就是前端网页的内容。Django通常配合HTML文件来渲染页面，将数据动态插入到网页中。

5. URL路由（URL Routing）

路由决定了访问哪个地址对应哪个视图函数。比如 /about 对应“关于我们”的页面。

---

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

接下来，我们将一步步创建一个最简单的网站——一个显示“Hello World”的页面。

第一步：创建项目

在命令行中执行以下命令：

django-admin startproject mysite

这会在当前目录下创建一个名为 mysite 的文件夹，里面是Django项目的骨架结构。

进入这个文件夹：

cd mysite

此时你会看到如下文件结构：

mysite/
├── manage.py          # Django的管理脚本
└── mysite/            # 项目配置文件
    ├── __init__.py
    ├── settings.py    # 项目设置文件
    ├── urls.py        # 路由配置文件
    └── wsgi.py

第二步：启动开发服务器

我们先测试一下默认的Django站点是否能正常运行。

执行下面的命令：

python manage.py runserver

打开浏览器访问 http://127.0.0.1:8000，你将看到Django的欢迎页面：

The install worked successfully! Congratulations!

恭喜，你已经成功创建了一个空的Django网站了！

第三步：创建应用

接下来我们创建一个应用，让它输出“Hello World”。

执行命令：

python manage.py startapp hello

这会生成一个叫做 hello 的应用文件夹。

现在你的项目结构变成这样：

mysite/
├── manage.py
├── mysite/
│   ├── settings.py
│   ├── urls.py
│   ...
├── hello/
│   ├── views.py
│   ├── models.py
│   ...

但是，Django还不知道我们新增了一个应用。需要把它添加到项目的设置里。

打开 mysite/settings.py 文件，在 INSTALLED_APPS 列表中加入 'hello'：

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

第四步：编写视图函数

打开 hello/views.py 文件，输入以下代码：

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, welcome to my first Django website!")

这段代码的作用是：当有人访问某个网页时，就返回一段文字“Hello...”。

第五步：配置URL路由

为了让用户可以通过特定的网址访问这个页面，我们需要配置URL路由。

打开 hello 应用文件夹，新建一个文件 urls.py，内容如下：

from django.urls import path
from . import views

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

然后回到 mysite/urls.py 文件，修改为如下内容：

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

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

这段代码表示：当你访问 /hello/ 的时候，就会交给 hello/urls.py 去处理。

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

再次运行服务器：

python manage.py runserver

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

你应该能看到页面显示：

Hello, welcome to my first Django website!

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

---

新手常见问题解答（FAQ）

下面是一些初学者经常遇到的问题，希望对你有帮助：

❓Q1：出现错误“ModuleNotFoundError: No module named ‘django’”怎么办？

✅ 原因：Django没有正确安装
✅ 解决办法：重新运行安装命令：

pip install django

如果还是不行，尝试升级pip后再装：

python -m pip install --upgrade pip

❓Q2：运行runserver的时候报错Port 8000 already in use怎么办？

✅ 原因：端口被其他程序占用了
✅ 解决办法：换一个端口号，例如：

python manage.py runserver 8001

然后访问 http://127.0.0.1:8001/hello/

❓Q3：我在哪里编辑网页内容？

✅ 当前例子中，我们在 views.py 中直接返回了字符串。
✅ 如果想展示真正的网页HTML，你需要创建一个 templates 目录，并结合 HTML 模板来展示内容。

我们将在下一阶段学习如何使用模板。

---

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

恭喜你完成了第一个Django网站！但这只是开始。接下来你可以继续学习以下内容：

推荐学习路线：

阶段	内容	推荐练习
第一阶段	模板系统 + 表单提交	创建一个留言板
第二阶段	模型 + 数据库操作	制作一个博客系统，支持增删改文章
第三阶段	用户认证系统	加入登录注册功能
第四阶段	静态资源处理	加入CSS、图片等美化页面
第五阶段	使用Admin后台管理	用Django自带后台轻松管理数据

推荐学习资源：

• Django官方中文文档
• 《Django实战》电子书
• B站搜索关键词“Django入门”，有很多免费教学视频

---

小结

在这篇教程中，我们从零开始安装了Python和Django，创建了一个简单的“Hello World”网站，并解释了一些关键概念。虽然这只是一个很小的功能，但它是你成为后端开发者的重要起点。

记住一句话：

编程最重要的不是看懂，而是自己动手试出来。

别担心看不懂或写错，多试几次，你会发现一切都越来越熟练！

如果你喜欢这篇教程，欢迎关注我，后面我会带你一步步做出更复杂的网站项目！🚀