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

知识库管理员

2025-06-28 03:43

阅读 666

一、开篇：Django 是什么？你能用它做什么？

如果你是零基础，第一次听说 Django，没关系！我们从最简单的解释开始。

Django 是一个使用 Python 编写的 Web 开发框架。

你可以把它理解为一套“建房子”的工具包。比如你想建一个博客网站、一个在线购物平台或者一个企业官网，Django 就可以帮你快速搭建出基本结构和功能。

使用 Django 可以做什么？

搭建个人博客
创建电商网站
实现用户登录注册功能
管理后台内容（CMS）
构建 API 接口（供手机App调用）

总之，Django 让你专注于实现业务逻辑，而不是重复造轮子，非常适合初学者快速入门 Web 开发！

二、环境准备：手把手教你搭建开发环境

在正式使用 Django 前，你需要先准备好一些开发工具。别担心，每一步都很简单。

所需软件/工具清单：

工具	作用
Python	编程语言，Django 的基础
pip	Python 包管理器，安装库用
Django	我们将要使用的框架
文本编辑器	写代码的工具，如 VS Code

✅ 步骤1：安装 Python（推荐3.8以上）

前往官网：https://www.python.org/downloads/

注意：

安装时请勾选 “Add to PATH”（Windows 用户）
安装完成后，在终端输入：
```
python --version
```
如果出现类似 Python 3.10.6，说明安装成功！

✅ 步骤2：安装 pip（大多数情况已自带）

pip --version

如果提示找不到命令，请查看安装 Python 时是否漏掉某些选项，也可以尝试运行以下命令升级：

python -m ensurepip --default-pip

✅ 步骤3：安装 Django

接下来，我们在命令行中使用 pip 来安装 Django：

pip install django

验证一下是否安装成功：

django-admin --version

显示版本号（例如 4.2.7）即表示安装成功！

✅ 步骤4：选择一个代码编辑器

我们推荐使用 VS Code（免费且功能强大）。

下载地址：https://code.visualstudio.com/

安装后记得安装 Python 插件，这样写代码会更方便。

三、核心概念：用通俗的语言解释关键术语

学习任何编程知识，都要先弄懂几个“关键词”。我们不讲太深奥的东西，只说最重要、最实用的部分。

📌 什么是 MVC？Django 是怎么工作的？

MVC 是一种架构模式，意思是“Model（模型）、View（视图）、Controller（控制器）”。

Django 虽然名字稍有不同，但思路是一样的：

Django 名称	对应角色	作用描述
models	数据模型	描述你要存的数据类型（如用户信息）
views	控制逻辑	处理用户的请求并返回结果
templates	页面展示	显示网页HTML内容

简单理解：

用户访问网址 → view 处理请求 → model 获取数据 → template 显示页面

📌 工作流简图示意

URL 请求 → urls.py (路由) → views.py (处理逻辑)
                           ↓
                    models.py (数据库操作)
                           ↓
                 templates (HTML模板) → 返回网页

📌 新手常见词汇一览表

术语	解释
项目（Project）	整个网站的基本结构（包含多个应用）
应用（App）	网站中的一个模块或功能板块（比如“博客”、“新闻”）
ORM	对象关系映射，让你用 Python 操作数据库
模板（Template）	HTML 页面 + Django 特有的变量语法
路由（URL）	把 URL 和处理函数连接起来

四、实战项目：一步步完成你的第一个 Django 网站

我们来做一个超级简单的网站——Hello World 网页。虽然听起来很基础，但这正是所有复杂网站的第一步！

步骤1：创建 Django 项目

打开命令行，进入你希望存放代码的目录，执行：

django-admin startproject mysite

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

进入这个文件夹：

cd mysite

看一下结构：

mysite/
├── manage.py           # 管理脚本（启动服务器、数据库等）
└── mysite/
    ├── __init__.py
    ├── settings.py     # 项目配置文件
    ├── urls.py         # 路由配置
    └── wsgi.py

步骤2：运行开发服务器

输入下面这条命令，启动本地服务器：

python manage.py runserver

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

你会看到 Django 默认欢迎页，说明你的环境没问题！

步骤3：创建第一个页面（Hello World）

1. 创建一个 App（应用）

我们的项目可以有多个功能模块，现在创建一个名为 hello 的 app：

python manage.py startapp hello

你会看到多了一个叫 hello 的目录，里面有默认文件。

2. 注册 App 到项目中

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

INSTALLED_APPS = [
    ...
    'hello',
]

3. 编写视图函数

打开 hello/views.py，编写以下代码：

from django.http import HttpResponse

def index(request):
    return HttpResponse("Hello, Django! 这是我的第一个网页")

4. 配置 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')),  # 新增这一行
]

5. 查看效果

再次运行服务器：

python manage.py runserver

访问：http://127.0.0.1:8000/hello/

你将会看到：

Hello, Django! 这是我的第一个网页

✅ 成功啦！这是你的第一个 Django 页面！

步骤4：用模板渲染网页（让页面好看点）

我们现在想把文字换成一个真正的网页（HTML），怎么做呢？

1. 创建模板文件夹

在 hello 目录下新建一个文件夹：

hello/templates/hello/index.html

然后在里面写一个简单的 HTML 页面：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hello Django</title>
</head>
<body>
    <h1>欢迎来到我的 Django 网站！</h1>
    <p>这是通过模板渲染出来的页面。</p>
</body>
</html>

2. 修改视图函数，使用模板

修改 hello/views.py：

from django.shortcuts import render

def index(request):
    return render(request, 'hello/index.html')

再次访问 http://127.0.0.1:8000/hello/，你会发现已经变成了一个漂亮的网页！

五、常见问题解答（新手最容易卡住的地方）

❓Q1：为什么提示 “ModuleNotFoundError: No module named ‘django’”？

可能原因：

Django 没有正确安装
安装了多个 Python 环境，当前激活的是错误版本

👉 解决方法：

尝试重新安装 Django：pip install django
检查当前 Python 是否是安装 Django 时所用的那个
```
which python  # Linux/Mac 下
where python  # Windows 下
```

❓Q2：我更改了代码，为什么页面没有变化？

可能是缓存导致的。试试：

强制刷新页面（Mac 上 Command+Shift+R / Windows Ctrl+F5）
关闭并重新运行服务器（Ctrl+C 停止后再 runserver）

❓Q3：URL 显示 404 Not Found

可能原因：

路由没写对
没有正确 include 应用的 url.py 文件
没有重启服务器

👉 检查重点：

路由是否拼错
是否忘记添加逗号或引号
视图函数名是否拼错

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

恭喜你完成了你的第一个 Django 项目！接下来你可以继续深入学习这些主题：

✅ 推荐学习路径：

数据库与模型 Model
- 学习如何定义表格结构，保存用户数据
- 使用 migrate 生成真实数据库表
表单 Forms
- 创建前端表单让用户输入信息
- 验证用户输入是否合法
后台 Admin
- 自动生成管理界面
- 方便管理网站内容
静态资源与媒体文件
- 加入 CSS、JS、图片等内容
- 设置静态文件路径
部署上线
- 如何把网站发布到互联网上
- 推荐平台：PythonAnywhere、Heroku、阿里云等

📚 推荐学习资源：

类型	推荐内容
官方文档	https://docs.djangoproject.com/zh-hans/
在线课程	Bilibili《Django入门实战》系列
图书推荐	《Django企业开发实战》《轻量级Django》
练手项目	博客系统、图书管理系统、留言墙、投票系统等

结语：坚持就是胜利！

Django 是非常成熟、社区活跃的 Web 框架。作为初学者，遇到问题是正常现象，关键是保持动手练习的热情。

💡记住一句话：“看得懂 ≠ 会做，做得出来才算真正学会。”

跟着教程动手敲一遍代码，哪怕一开始只是照着写，慢慢就能建立信心，掌握技能。

加油！你的程序员之路才刚刚开始！

🎉 你现在已经是会使用 Django 的初级开发者了！要不要试着做个自己的小网站练手？

标签:面试题Go

最热最新

暂无评论

为你推荐

暂无相关推荐