Django入门教程：搭建你的第一个Python网站
一、开篇：Django是什么？我能用它做什么？
想象一下，你是一个刚学编程的新手，想要建一个属于自己的网站。你可能会想到写HTML页面、设计界面，甚至加上一些功能。但很快你会发现，这些操作只能做出“静态”网页——比如一个只有文字和图片的介绍页。
Django 就是用来帮助你构建“动态”网站的强大工具。所谓“动态”，就是这个网站可以：
- 显示数据库里的内容（例如用户评论、新闻文章）
- 根据用户输入做出不同反应（例如登录后显示个性化信息）
- 实现复杂的功能（如在线商城、博客系统）
简单地说：Django 是一个让你用 Python 快速开发网站的框架。它可以帮你省去很多重复的工作，专注在你想实现的功能上。
二、环境准备：搭建你的Django开发环境
第一步：安装 Python 和 pip
确认你的电脑是否已经安装了 Python：
python --version
如果没有安装，请前往 https://www.python.org/downloads/ 下载并安装最新版本（建议选择 Python 3.10 或以上）。
⚠️ 安装时务必勾选“Add to PATH”，否则后续命令可能无法识别。
验证 pip 是否可用：
pip --version
如果你看到类似这样的输出，说明一切正常：
pip 24.x.x from C:\Python312\lib\site-packages\pip (python 3.12)
第二步：创建虚拟环境（venv）
我们在做项目时，推荐使用虚拟环境来隔离每个项目的依赖，避免包冲突。
创建虚拟环境：
python -m venv myenv
激活虚拟环境：
- Windows：
myenv\Scripts\activate - macOS / Linux：
source myenv/bin/activate
激活成功后，命令行前会出现 (myenv) 表示当前处于虚拟环境中。
第三步：安装 Django
在虚拟环境中安装 Django：
pip install django
安装完成后检查版本：
django-admin --version
如果输出类似这样，就表示安装成功：
4.2.6
三、Django核心概念解析（零基础也能理解）
为了不吓跑初学者，我们先不说太多专业术语。下面我用日常比喻带你快速理解 Django 的三大核心概念：
| 概念 | 类比解释 | 作用 |
|---|---|---|
| 项目（Project） | 整个网站的大房子 | 包含多个网页（应用）的整体结构 |
| 应用（App） | 房子中的房间（如厨房、卧室） | 实现某一个具体功能的模块 |
| 视图（View） | 控制器，决定显示什么内容 | 处理逻辑，返回给用户看到的网页内容 |
你可以简单理解为：
Django 项目就像一个大网站，它由一个个小功能模块（应用）组成；每个应用内部有视图来控制展示哪些内容。
四、实战项目：创建你的第一个Django网站
我们将一步步创建一个名为“我的第一个网站”的项目，并添加一个主页。
步骤1：创建项目
在命令行中运行以下命令：
django-admin startproject first_site
你会看到生成了一个叫 first_site 的文件夹，里面是 Django 的基本项目结构：
first_site/
├── manage.py # 管理项目的命令工具
└── first_site/
├── __init__.py # 告诉Python这是一个包
├── settings.py # 网站配置文件
├── urls.py # 网站的路由入口
└── wsgi.py # 部署用的配置文件
步骤2：启动内置服务器，预览网站
进入项目目录：
cd first_site
运行开发服务器：
python manage.py runserver
访问 http://127.0.0.1:8000，你应该能看到 Django 默认欢迎页面！
步骤3：创建一个简单的网页（首页）
我们要实现一个主页，网址是 /，也就是首页。
3.1 创建一个视图函数
打开 first_site/views.py，添加如下代码：
from django.http import HttpResponse
def home(request):
return HttpResponse("欢迎来到我的第一个Django网站！")
现在我们写了一个叫做 home 的函数，它接收到请求 request 后会返回一句话。
3.2 给视图绑定一个网址
我们需要告诉 Django：“当用户访问 / 这个地址时，调用 home 函数”。
打开 first_site/urls.py，修改成如下内容：
from django.contrib import admin
from django.urls import path
from first_site.views import home # 导入我们刚刚写的home函数
urlpatterns = [
path('', home), # 访问根路径'/'时调用home函数
]
再次运行服务器：
python manage.py runserver
刷新浏览器，你现在应该能看到这句话：
欢迎来到我的第一个Django网站！
🎉 恭喜你，你已经完成了第一个Django网页！
步骤4：创建第二个页面 —— 关于页面
我们再来加一个页面，网址是 /about/。
4.1 添加视图函数
打开 views.py，添加一个新的函数：
def about(request):
return HttpResponse("这是关于页面，你好呀！")
4.2 设置 URL 路由
修改 urls.py：
urlpatterns = [
path('', home),
path('about/', about), # 新增一条路径
]
现在访问 http://127.0.0.1:8000/about/ 应该就能看到关于页面的内容啦！
五、常见问题解答（FAQ）
Q1：为什么不能直接打开网页文件，非要运行服务器？
因为 Django 是一个动态网站框架，它的网页不是写死的 .html 文件，而是通过 Python 函数动态生成内容。所以必须运行服务器才能让这些代码被调用。
Q2：运行服务器时报错说某个端口已被占用怎么办？
可能是上次运行没有关掉服务。解决方法：
- 找到之前的终端窗口按
Ctrl + C停止服务。 - 或者换一个端口号启动：
python manage.py runserver 8001
Q3：URL路径怎么命名比较合适？
建议遵循几个原则：
- 保持简短清晰
- 使用英文
- 用小写和横线分隔词（如
/blog/post-detail/）
Q4：每次改完代码要重启服务器吗？
在开发过程中，Django 自带的开发服务器会在你保存代码后自动重启，不需要手动重新运行。
六、学习建议：下一步该怎么继续？
恭喜你完成了第一个 Django 网站！这只是开始，接下来你可以尝试：
学习方向一：模板系统 —— 显示更丰富的网页
目前我们只是用 HttpResponse 显示纯文本。如果你想显示 HTML 页面，就要用到 Django 的模板系统。
关键词：render(), templates 目录, HTML 渲染
学习方向二：模型系统 —— 操作数据库
Django 提供了一个强大的 ORM（对象关系映射），让你可以用 Python 对数据库进行增删查改。
关键词：models.Model, 迁移文件, makemigrations, migrate
学习方向三：管理后台 —— 快速建数据管理系统
Django 提供了一个自带的后台管理系统，几行代码就可以建立一个可视化的数据管理界面。
关键词：admin.site.register, 超级用户创建
结语
本教程从零开始，带你一步步完成了 Django 项目的创建和第一个网页的开发。希望你在这个过程中体会到编程的乐趣，以及 Django 如何简化网站开发的流程。
虽然只是一个简单的网站，但它为你打开了通向完整 Web 开发的大门。只要坚持每天敲一点代码，多动手实践，相信你很快就能做出更复杂、更好看的网站！
加油，未来的程序员 👩💻👨💻！
评论 0