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

周华

2025-06-13 23:09

阅读 775

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

Django 是一个用 Python 编写的 Web框架。如果你是零基础的新手，可能对“Web框架”这个词不太熟悉，没关系，我们来拆解一下：

Web：就是互联网上的网页、网站。
框架：是一套预先写好的程序结构和功能模块，帮你快速开发，就像盖房子的脚手架。

所以你可以把 Django 看作是一个帮你快速开发网站的“工具箱”。它已经帮你完成了很多重复性工作，比如用户登录、数据库连接、页面管理等，你只需要专注于写自己的业务逻辑即可。

为什么选择 Django？

官方文档齐全，社区活跃
功能强大，适合做各种类型的网站（博客、电商、管理系统）
学完之后可以做出完整项目，提升求职竞争力

现在就让我们一步一步来创建属于你的第一个Django网站吧！

第一步：环境准备（从零开始）

在开始写代码之前，我们要先准备好 Python 和 Django 的运行环境。

1. 安装 Python

提示：Django 是基于 Python 的，所以第一步当然是安装 Python。

前往 https://www.python.org/downloads/
下载最新版本（目前建议使用 Python 3.10~3.12之间）
安装时一定要勾选 "Add to PATH"
安装完成后，在命令行输入以下命令查看是否安装成功：

python --version

或者 macOS/Linux 用户可以用：

python3 --version

如果显示类似 Python 3.12.2，说明安装成功 ✅

2. 安装虚拟环境（推荐）

虚拟环境可以帮助你为每个项目配置独立的依赖库，避免冲突。

安装 venv（Python 自带）：

# 创建一个虚拟环境目录
python -m venv myvenv

# 激活虚拟环境（Windows）
myvenv\Scripts\activate

# macOS / Linux
source myvenv/bin/activate

激活后你会看到命令行前面多了 (myvenv)，表示当前在虚拟环境中。

3. 安装 Django

在激活的虚拟环境中执行：

pip install django

安装完成后，检查一下版本：

django-admin --version

如果输出类似 4.2.10，说明安装完成 ✅

第二步：核心概念介绍（通俗易懂）

学框架就像学语言，有一些基本术语需要理解清楚。下面是最基础的概念，我们用生活中的比喻来解释它们。

概念	通俗解释	示例
项目	整个网站的大本营，比如“某淘宝网”	一个文件夹，包含多个应用
应用	具体的功能模块，比如“商品管理”、“用户登录”	一个小功能模块
视图 (View)	处理用户请求，返回数据给前端	就像客服处理问题
URL路由	把不同的地址分派给不同视图	类似公司前台接待分配部门
模板 (Template)	显示网页内容，通常配合HTML使用	就像网页外观设计图纸
模型 (Model)	和数据库打交道的类	相当于Excel表格的设计

接下来我们会通过实战来一一掌握这些概念。

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

我们将从头开始创建一个最简单的网站，让它能响应访问，并展示“Hello World”。

1. 创建项目

首先用 Django 命令新建一个项目：

django-admin startproject mysite

这会在当前目录下生成一个名为 mysite 的文件夹，里面是你的网站骨架。

进入项目目录：

cd mysite

启动服务器试试看：

python manage.py runserver

浏览器打开 http://127.0.0.1:8000/，如果看到欢迎页，恭喜你网站启动成功 ✅

按 Ctrl+C 停止服务器。

2. 创建第一个应用

还记得前面说的应用吗？我们现在创建一个叫 pages 的应用来管理页面内容。

回到项目根目录并运行命令：

python manage.py startapp pages

这样就会多出一个 pages 文件夹。

然后记得在 mysite/settings.py 中注册这个应用：

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

3. 编写第一个视图（View）

编辑 pages/views.py 文件，添加如下代码：

from django.http import HttpResponse

def home_page(request):
    return HttpResponse("这是我的第一个网页！")

这就是一个非常简单的视图函数：收到请求后，返回一段文字。

4. 配置URL路由

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

在 pages 目录下新建文件 urls.py，内容如下：

from django.urls import path
from . import views

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

然后在项目的主路由文件 mysite/urls.py 中引入这个应用的路由：

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

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

5. 再次运行服务器

python manage.py runserver

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

你将会看到 “这是我的第一个网页！” ——恭喜你，你的第一个Django网页跑起来了！

第四步：进阶一点——使用模板渲染HTML页面

刚才我们只是用了纯文本响应，实际中我们想显示好看的 HTML 页面，怎么做呢？

1. 创建模板目录结构

Django 会自动搜索模板目录。我们在 pages 下创建一个 templates/pages/ 目录结构，并在里面添加一个 HTML 文件：

pages/
└── templates/
    └── pages/
        └── home.html

注意：templates 是固定命名；里面再建一层 pages 是为了防止与其他应用同名模板冲突。

2. 编写 HTML 模板

打开 home.html，写入以下内容：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>我的第一个Django网站</title>
</head>
<body>
    <h1>Hello, 欢迎来到我的网站！</h1>
    <p>这是一个用 Django 制作的网站主页。</p>
</body>
</html>

3. 修改视图以使用模板

修改 views.py：

from django.shortcuts import render

def home_page(request):
    return render(request, 'pages/home.html')

保存后重启服务器（Ctrl + C → 回车 → 重新运行 runserver），刷新页面就能看到完整的 HTML 页面了！

第五步：常见问题解答（FAQ）

作为一个刚入门的新手，你可能会遇到一些奇怪的问题。下面是一些常见的问题及解决方案：

🤔 为什么运行不了？提示 command not found？

原因：可能是 Python 或 pip 没有加入系统路径。
解决：重新安装 Python 并确保勾选“Add to PATH”

🤔 manage.py: can't open file 'manage.py': [Errno 2] No such file or directory

原因：没有进入项目目录
解决：使用 cd mysite 进入项目根目录后再执行命令

🤔 页面不更新？明明改了 HTML 却没变

原因：浏览器缓存或服务未重启
解决：刷新页面时按住 Shift，同时强制刷新；或关闭终端重新启动服务

🤔 TemplateDoesNotExist 错误

原因：模板路径不对
解决：
- 检查模板路径是否为 templates/pages/xxx.html
- 查看 views.render() 中传的路径是否正确

🤔 如何退出虚拟环境？

在命令行中输入：

deactivate

就可以退出当前虚拟环境，回到全局 Python。

第六步：下一步学习建议

恭喜你，现在已经拥有了一个可运行的 Django 网站，哪怕只是一个简单页面，但也代表你跨出了成为 Python Web 开发者的第一步！

下面是接下来你可以尝试学习的内容方向：

总结

在这篇文章中，我们完成了以下几件事：

了解了 Django 是什么，有什么优势
搭建了开发环境（Python + Django + 虚拟环境）
创建了一个最小化的 Django 网站项目
学会了视图、URL路由、模板的基本用法
遇到问题学会了排查方法
规划了后续的学习路线

只要坚持练习，每天进步一点点，相信不久的将来你也可以做出炫酷的网站！

💡 学编程不是记住所有知识，而是“动手+思考”的过程。不要怕犯错，每解决一个问题，你就离高手更近了一步！

如果你想继续深入学习，可以关注我后续的文章《Django进阶教程：数据库操作与用户认证系统》。

标签:产品PythonJavascript

最热最新

暂无评论

为你推荐

暂无相关推荐