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

倾国倾城

2025-06-19 06:28

阅读 242

开篇：Django是什么？为什么选择它？

如果你是刚开始学习编程的新手，可能听说过“网站开发”这个词。简单来说，网站开发就是创建一个可以被访问的网页程序。而Django，正是这样一个让你更容易开发网站的强大工具。

Django 是一个基于 Python 的 Web 框架（Web Framework）。你可以把它想象成是一个为程序员准备的“建房工具包”——它提供了很多现成的功能，比如数据库管理、用户登录系统、后台管理页面等，帮助你更快速地构建功能完善的网站。

那为什么要选 Django 呢？因为它：

✅ 简洁易学，适合初学者
✅ 功能全面，自带许多实用模块
✅ 社区活跃，资料丰富
✅ 被许多知名网站使用，例如 Instagram 和 Pinterest

接下来的内容将带你一步步从零开始，用 Django 搭建自己的第一个网站！

环境准备：搭建你的 Python 开发环境

在写代码之前，我们需要先准备好必要的开发工具。以下是详细的安装步骤。

第一步：安装 Python

请前往官网 https://www.python.org/downloads/ 下载最新的稳定版本（目前推荐 3.10 或更高）。

安装时请勾选 Add Python to PATH（Windows 系统），这样之后在命令行中就可以直接使用 python 命令了。

验证是否安装成功，在终端或命令提示符输入：

python --version

如果看到类似 Python 3.11.x 的输出，说明安装成功！

第二步：安装 pip（Python 包管理器）

pip 是用来安装 Python 包的工具，通常在安装 Python 时会一并安装。验证一下：

pip --version

如果有版本号显示出来，就 OK。如果没有，请手动安装。

第三步：安装虚拟环境（virtualenv）

为了保持项目的独立性和整洁性，我们建议每个项目使用独立的“虚拟环境”。安装命令如下：

pip install virtualenv

第四步：安装 Django

接下来我们要正式安装 Django。在命令行中执行以下命令：

pip install django

等待安装完成后，我们可以通过下面的命令查看当前安装的 Django 版本：

django-admin --version

你应该看到类似 4.2.x 的版本号。

小结一下你需要完成的步骤：

安装 Python
安装 pip
安装 virtualenv
创建虚拟环境（可选但推荐）
安装 Django

✅ 到这一步，你的开发环境已经配置完毕啦！

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

刚接触 Django 的时候，你会遇到一些专业术语，比如“项目”、“应用”、“模板”、“URL路由”等等。别担心，我们来一一解释这些概念，并用通俗的语言让你明白它们的作用。

📌 Django 项目的结构

当我们说“创建一个项目”，其实就是建立一个完整的网站。Django 项目包含多个“应用”（App），每个 App 对应网站的一个功能模块。

举个例子：一个博客网站的项目，可能包括：

博客文章 App（负责展示文章）
用户评论 App（处理留言）
后台管理 App（用于管理员发布内容）

这样的分块设计，使得我们的项目更加清晰、易于维护。

🔧 核心组件介绍

组件	中文名称	用途说明
project	项目	整个网站的总容器，管理全局配置
app	应用	实现具体功能的模块
urls.py	URL 配置文件	控制浏览器地址如何映射到页面
views.py	视图函数	处理请求，并返回网页内容
models.py	数据模型	定义网站使用的数据结构（如文章标题、作者）
templates	模板目录	存放 HTML 页面，用于渲染网页内容

我们可以把它们比作一个餐馆的不同角色：

项目 = 整个餐厅
App = 不同部门（厨房、前厅、洗碗间）
urls.py = 引导顾客找座位的服务员
views.py = 主厨，决定上什么菜
models.py = 食材清单
templates = 菜谱，告诉主厨怎么摆盘

🔁 MVC vs MTV 架构简介（非必须掌握）

有些框架使用 MVC（Model - View - Controller）模式。而 Django 使用的是类似的 MTV 架构：

Model（模型） = 数据库相关的部分（对应 models.py）
Template（模板） = 显示网页的部分（对应 templates 目录）
View（视图） = 处理业务逻辑（对应 views.py）

所以你看，其实本质上是一样的，只是名字略有不同而已。

实战项目：用 Django 搭建一个简易的“Hello World!”网站

现在是时候动起手来了！我们将创建一个最简单的网站：当用户访问主页时，显示 “Hello, welcome to my first Django site!”

步骤一：创建你的第一个项目

打开命令行工具，进入你想存放项目的文件夹，然后执行：

django-admin startproject mysite

这个命令会创建一个名为 mysite 的项目文件夹，里面包含了初始文件。

进去看看：

cd mysite
ls

你应该能看到几个 .py 文件，其中最重要的有：

manage.py：项目的管理脚本
settings.py：项目的设置文件
urls.py：网站的路由配置

步骤二：运行服务器测试项目是否正常

我们现在来启动本地开发服务器，测试一下：

python manage.py runserver

打开浏览器，访问 http://127.0.0.1:8000/，你会看到 Django 提供的欢迎页面。

✅ 成功了！你现在有一个可以运行的 Django 网站框架了！

步骤三：添加你的第一个网页 —— Hello World!

接下来我们想实现一个简单的页面：用户访问 /hello 时显示 "Hello, welcome to my site!"

1️⃣ 编辑 `views.py`

进入 mysite/mysite/views.py 文件，添加一个简单的视图函数：

from django.http import HttpResponse

def hello(request):
    return HttpResponse("Hello, welcome to my site!")

这个函数接收一个 request 请求对象，并返回一个响应文本。

2️⃣ 配置 URL 路由

接着，打开 urls.py（注意不是根目录下的那个，而是 mysite/mysite/urls.py），进行修改：

from django.urls import path
from . import views  # 导入 views 模块

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

保存后刷新页面。访问 http://127.0.0.1:8000/hello/，你应该就能看到你写的文字啦！

🎉 成功了！这是你的第一个自定义 Django 页面！

进阶一点：让网页显示 HTML 内容（HTML + 模板）

刚才我们只用了纯文本输出，如果你想让它看起来像一个真正的网页，就需要使用 HTML。

步骤一：创建模板目录

在项目根目录下新建一个 templates 文件夹。
在该文件夹内创建一个 HTML 文件，例如：index.html

编辑这个文件：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>我的第一个Django网站</title>
</head>
<body>
    <h1>欢迎来到我的世界！</h1>
    <p>这是一个通过 Django 渲染的 HTML 页面。</p>
</body>
</html>

步骤二：配置模板路径

回到 settings.py，找到 TEMPLATES 设置项，修改 DIRS 行为如下：

TEMPLATES = [
    {
        ...
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        ...
    },
]

步骤三：修改视图函数，渲染模板

再次打开 views.py，更新我们的视图：

from django.shortcuts import render

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

刷新页面，你会发现页面变成了我们刚刚写的 HTML 页面。

✅ 成功了！你现在可以用 Django 来展示复杂的 HTML 网页了！

常见问题解答 💬

作为新手，在学习过程中可能会遇到一些常见问题。下面列出一些常见的问题和解决办法。

❓Q1：运行 `runserver` 报错，提示找不到模块怎么办？

可能是没有激活虚拟环境，或者依赖没有安装完整。尝试以下命令重新安装依赖：

pip install -r requirements.txt

如果没有这个文件，试试单独安装 Django：

pip install django

❓Q2：我改了代码，但是网页没有变化怎么办？

有时候 Django 不会自动重新加载。按下 Ctrl+C 关闭服务器后重新运行：

python manage.py runserver

❓Q3：为什么访问 `localhost:8000` 页面报错 404？

因为我们在前面配置了 /hello/ 这个路径，原来的首页并没有内容。可以添加一个新的空路径：

path('', views.hello),  # 新增首页

这样访问 127.0.0.1:8000 就能直接看到首页内容了。

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

恭喜你完成了第一个 Django 小项目！但这只是刚刚开始，以下是一些继续深入的方向建议：

📚 推荐学习内容：

✅ 使用模型（Model）操作数据库
✅ 实现表单提交功能
✅ 模板继承与静态文件（CSS、JS）处理
✅ 使用 Admin 后台管理系统
✅ 部署网站到线上服务器（如 Heroku）

📘 推荐资源：

Django 官方文档：https://docs.djangoproject.com/
免费中文教程：掘金、知乎、B站搜索“Django 入门”
推荐书籍：《Fluent Python》《Django for Beginners》

总结

本文介绍了 Django 的基本概念与开发流程，一步一步带你创建了自己的第一个 Django 网站。虽然只是一个简单的示例，但它为你打下了坚实的基石。

记住一句话：“实践是最好的老师。”多敲代码，多做小项目，你会发现 Django 越来越得心应手。加油！

📌 扩展阅读：想了解 Django 如何连接数据库、做用户登录注册等功能？欢迎关注后续进阶课程《Django实战：打造个人博客系统》，帮你迈出成为全栈开发者的第二步！

标签:运营实战经验Python

最热最新

暂无评论

为你推荐

暂无相关推荐

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

开篇：Django是什么？为什么选择它？

环境准备：搭建你的 Python 开发环境

第一步：安装 Python

第二步：安装 pip（Python 包管理器）

第三步：安装虚拟环境（virtualenv）

第四步：安装 Django

小结一下你需要完成的步骤：

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

📌 Django 项目的结构

🔧 核心组件介绍

🔁 MVC vs MTV 架构简介（非必须掌握）

实战项目：用 Django 搭建一个简易的“Hello World!”网站

步骤一：创建你的第一个项目

步骤二：运行服务器测试项目是否正常

步骤三：添加你的第一个网页 —— Hello World!

1️⃣ 编辑 `views.py`

2️⃣ 配置 URL 路由

进阶一点：让网页显示 HTML 内容（HTML + 模板）

步骤一：创建模板目录

步骤二：配置模板路径

步骤三：修改视图函数，渲染模板

常见问题解答 💬

❓Q1：运行 `runserver` 报错，提示找不到模块怎么办？

❓Q2：我改了代码，但是网页没有变化怎么办？

❓Q3：为什么访问 `localhost:8000` 页面报错 404？

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

📚 推荐学习内容：

📘 推荐资源：

总结

评论 0

为你推荐

精选内容

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

开篇：Django是什么？为什么选择它？

环境准备：搭建你的 Python 开发环境

第一步：安装 Python

第二步：安装 pip（Python 包管理器）

第三步：安装虚拟环境（virtualenv）

第四步：安装 Django

小结一下你需要完成的步骤：

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

📌 Django 项目的结构

🔧 核心组件介绍

🔁 MVC vs MTV 架构简介（非必须掌握）

实战项目：用 Django 搭建一个简易的“Hello World!”网站

步骤一：创建你的第一个项目

步骤二：运行服务器测试项目是否正常

步骤三：添加你的第一个网页 —— Hello World!

1️⃣ 编辑 views.py

2️⃣ 配置 URL 路由

进阶一点：让网页显示 HTML 内容（HTML + 模板）

步骤一：创建模板目录

步骤二：配置模板路径

步骤三：修改视图函数，渲染模板

常见问题解答 💬

❓Q1：运行 runserver 报错，提示找不到模块怎么办？

❓Q2：我改了代码，但是网页没有变化怎么办？

❓Q3：为什么访问 localhost:8000 页面报错 404？

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

📚 推荐学习内容：

📘 推荐资源：

总结

评论 0

为你推荐

相关推荐

精选内容

1️⃣ 编辑 `views.py`

❓Q1：运行 `runserver` 报错，提示找不到模块怎么办？

❓Q3：为什么访问 `localhost:8000` 页面报错 404？