Django入门教程：搭建你的第一个Python网站
开篇：Django是做什么的？
你有没有想过，自己动手做一个网站？不用慌张，其实只要你会一点点Python基础，就能用 Django 来快速搭建一个完整的网站。
Django 是一款用于构建Web应用程序的开源框架，它使用 Python 编写。简单来说，你可以把它理解成一个“网站制造器”，帮助你把后端数据（比如用户信息、文章内容）和前端页面连接起来，并处理用户的请求，比如点击按钮、提交表单等。
本篇教程将带零基础的你，从安装环境开始，一步步完成你的第一个 Django 网站项目。
一、环境准备：搭建开发工具链
1. 安装Python
在开始之前，确保你的电脑上安装了 Python。打开终端（Mac/Linux）或命令提示符（Windows），输入以下命令：
python --version
如果看到类似 Python 3.x.x 的版本号，说明已经安装好了。如果没有，前往官网 https://www.python.org/downloads/ 下载对应操作系统的最新稳定版。
✅ 提示：务必选择 Python 3 版本，目前主流推荐为 Python 3.9 到 3.11。
2. 安装 pip
pip 是 Python 包管理工具，用于安装各种库。检查是否已安装：
pip --version
没有的话可以重新运行 Python 安装程序并勾选 "Add to PATH" 或者参考官方文档进行配置。
3. 创建虚拟环境（Virtual Environment）
为了避免系统中不同项目的依赖冲突，我们建议使用 虚拟环境 来隔离项目依赖。
创建虚拟环境命令如下：
python -m venv myenv
启动虚拟环境：
- Windows:
myenv\Scripts\activate
- Mac / Linux:
source myenv/bin/activate
激活成功后，命令行前面会显示 (myenv) 字样。
4. 安装 Django
现在我们可以安装 Django：
pip install django
验证是否成功安装：
django-admin --version
出现版本号即表示安装成功！
二、核心概念：理解 Django 的工作原理
学 Django 前，你需要了解几个核心概念：
🧩 1. MVT 架构模式
MVT = Model + View + Template
这是 Django 使用的一种结构设计方式：
| 名称 | 作用 |
|---|---|
| Model | 负责与数据库交互，保存数据 |
| View | 处理逻辑、接受请求并返回响应 |
| Template | 展示页面内容的模板文件 |
💡 可以想象：Model 是仓库里的商品信息，View 是售货员，Template 是货架上陈列的商品广告牌。
📁 2. Django 项目的目录结构
当你创建完一个项目后，你会看到如下结构：
myproject/
├── manage.py # 管理脚本（执行命令用）
└── myproject/
├── __init__.py # 初始化模块
├── settings.py # 全局配置文件
├── urls.py # 页面路由设置
└── wsgi.py # 部署服务器时使用的入口
🔌 3. URL 与视图的关系
URL 决定访问路径，视图决定响应什么内容。
例如：
- 当你在浏览器输入
/hello/，这个就是 URL。 - Django 在
urls.py中找到对应的视图函数，调用执行。 - 视图函数处理完成后，返回内容给用户。
三、实战项目：用Django做第一个网站 —— Hello World!
我们将一起创建一个简单的网页：“欢迎来到我的首页”。
步骤 1：创建项目
在你想存放项目的目录下执行：
django-admin startproject myproject
cd myproject
生成的项目结构如前文所示。
步骤 2：创建应用 app
Django 推荐使用多个 “app” 拆分功能。我们现在创建一个名为 pages 的应用：
python manage.py startapp pages
此时你会发现多了一个名为 pages 的文件夹。
我们需要把这个 app 注册到项目的设置中。编辑 myproject/settings.py 文件，在 INSTALLED_APPS 列表中添加 'pages'：
INSTALLED_APPS = [
...
'pages',
]
步骤 3：编写视图函数
打开 pages/views.py 文件，输入以下代码：
from django.http import HttpResponse
def home(request):
return HttpResponse("你好，欢迎访问我的网站！")
这段代码定义了一个视图函数 home()，当有人访问此页面时，就显示一句话。
步骤 4：配置 URL 路由
接下来需要让 Django 知道哪个网址触发上面的视图函数。
打开 pages/urls.py 文件（如果没有就新建一个），添加如下内容：
from django.urls import path
from . import views
urlpatterns = [
path('', views.home, name='home'),
]
然后去主项目的 urls.py 添加对 pages 的引用：
from django.urls import include, path
urlpatterns = [
path('', include('pages.urls')),
]
步骤 5：运行服务器，查看效果
现在启动开发服务器：
python manage.py runserver
打开浏览器访问 http://127.0.0.1:8000，你应该能看到如下界面：
👀 你好，欢迎访问我的网站！
🎉 恭喜！你的第一个 Django 页面诞生了！
四、新手常见问题解答
Q1：为什么运行的时候报错 ModuleNotFoundError?
A：可能是没激活虚拟环境或者没正确安装 Django，尝试重新执行 pip install django 或者确认环境变量是否正确。
Q2：我改了代码为啥没生效？
A：运行的是旧的缓存？尝试重启服务 Ctrl+C 停止后再执行 runserver。
Q3：能不能不加虚拟环境？
A：虽然可以，但随着学习深入，强烈建议养成使用虚拟环境的好习惯，避免后期混乱。
Q4：怎么退出虚拟环境？
A：终端输入 deactivate 即可退出当前环境。
五、学习建议：下一步往哪里走？
恭喜你完成了第一个 Django 网站项目。接下来你可以继续深入以下几个方向：
1. 学习数据库操作：模型 Models
让你的数据持久化存储，实现用户注册、文章发布等功能。
2. 使用模板 Templates 返回 HTML 页面
替换之前的纯文本输出，展示更漂亮的网页。
3. 加入用户认证 User Authentication
实现登录、登出、权限控制等高级功能。
4. 进阶：部署上线网站
学习如何把本地项目上传到网络服务器，让别人也能访问。
小结一下 ✅
| 学习阶段 | 内容要点 |
|---|---|
| 环境搭建 | 安装 Python、pip、虚拟环境、Django |
| 核心知识 | MVT 结构、URL 与视图关系 |
| 实战练习 | 创建网站主页，展示 Hello World! |
| 常见问题 | 解决导入错误、运行异常等问题 |
| 后续计划 | 数据库、模板、部署上线等进阶学习 |
如果你坚持一步一步跟着实践操作，相信不出几天，你就能做出属于自己的博客站点、个人作品集或者企业官网啦！
继续加油吧，未来的程序员 💻✨
评论 0