Django入门教程：搭建你的第一个Python网站
一、开篇：Django是什么？它可以用来做什么？
你是不是听说过“用 Python 写网页”这样的说法？其实，这就是我们今天要学的 Django 的主要用途。
Django 是一个用 Python 编写的 Web 框架（web framework），它的作用是帮助开发者快速、安全地构建网站和 Web 应用程序。
如果你的目标是：
- 学会开发博客网站
- 做出自己的个人主页或管理系统
- 搭建一个在线投票系统或者商城后台
- 或者为数据科学项目提供可视化前端页面
那么 Django 就是一个非常适合入门的选择！
二、环境准备：搭建你的开发环境
在开始写代码之前，我们需要准备好以下工具：
✅ 1. 安装 Python
建议安装 Python 3.9 到 3.11 版本之间。你可以从官网下载安装包：https://www.python.org/downloads/
安装完成后，在命令行中输入以下命令检查是否安装成功：
python --version
如果出现类似 Python 3.x.x 的信息，说明你已经安装好 Python。
✅ 2. 安装 pip（Python 包管理工具）
pip 是 Python 自带的一个包管理工具，可以用来安装各种库。我们通常使用它来安装 Django。
检查是否已安装 pip：
pip --version
如果没有安装，请到官网查看具体方法 https://pip.pypa.io/en/stable/installation/
✅ 3. 安装 Django
使用 pip 安装最新版本的 Django：
pip install django
安装完成后，运行以下命令确认安装成功：
django-admin --version
出现类似 4.2.5 的数字就表示安装成功啦！
三、核心概念：理解 Django 是怎么工作的
为了更好地学习，我们先了解几个重要的术语。
🧠 网站是怎么运作的？
简单地说：
- 用户访问网址（如 http://localhost:8000）
- 服务器收到请求，处理逻辑并返回内容
- 浏览器显示结果（比如一个网页）
而 Django 就是帮我们完成中间部分 —— 即如何响应用户请求、处理数据等。
📌 关键名词解释（通俗版）：
| 名词 | 含义 |
|---|---|
| Project（项目） | 整个网站的大框架，包含多个小模块 |
| App（应用） | 具体功能模块，比如博客文章、用户注册等 |
| View（视图） | 负责处理用户的请求，返回页面内容 |
| URL（网址） | 把浏览器请求映射到指定的 view 上 |
| Template（模板） | 实际上就是 HTML 页面文件 |
| Model（模型） | 对应数据库中的表格，用于存储数据 |
💡 类比：一个网站就像一座大厦，project 是整个建筑，app 就像不同的房间，view 是房间里的电视节目，url 是门牌号，template 是电视显示的画面，model 是房子的水电管线。
四、实战项目：跟着教程一步步做自己的网站
我们来做一个小网站吧！目标是创建一个首页，当你访问时会看到一句话：“欢迎来到我的网站！”
第一步：创建一个 Django 项目
打开命令行，执行下面的命令创建项目：
django-admin startproject mysite
这会在当前目录下创建一个名为 mysite 的文件夹，进入这个文件夹：
cd mysite
第二步：运行开发服务器测试网站
运行以下命令启动服务器：
python manage.py runserver
你会看到输出信息，提示服务器正在运行，默认地址是 http://127.0.0.1:8000
打开浏览器，输入上面网址，你应该能看到 Django 默认的欢迎页面。
🎉 成功了第一步！
第三步：创建一个 app
现在我们要做一个具体的功能模块（app），假设我们做的是“欢迎页”。
运行以下命令创建一个 app：
python manage.py startapp welcome
这个命令会在项目中添加一个叫做 welcome 的模块。
接着需要告诉 Django 我们新创建了这个 app。打开 mysite/settings.py 文件，在 INSTALLED_APPS 里加上：
'welcome.apps.WelcomeConfig',
保存后，我们的 app 就注册好了！
第四步：编写视图 view 并设置 URL
编辑 welcome/views.py，在里面写一个简单的函数：
from django.http import HttpResponse
def index(request):
return HttpResponse("欢迎来到我的网站！")
接下来配置 URL 映射：
新建文件 welcome/urls.py，然后写入如下内容：
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
]
然后再去主项目的 urls.py（在 mysite/urls.py 中）加入对 app 的引用：
修改后的 urls.py 内容如下：
from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('welcome.urls')),
]
第五步：再次启动服务器测试效果
再次运行服务：
python manage.py runserver
刷新浏览器页面，你现在应该能看到：
欢迎来到我的网站！
✅ 恭喜你，你已经完成了你的第一个 Django 页面！
五、常见问题解答
❓Q1：为什么我的网站访问不了？
可能是以下原因：
- 服务器没有启动：请确保你运行了
runserver - 地址不对：默认是
http://127.0.0.1:8000 - 端口被占用：换一个端口号试试，例如：
runserver 8080
❓Q2：修改代码后为什么没生效？
Django 开发服务器有热重载功能，一般情况下自动生效。但如果你手动关闭过服务器，记得重新运行。
❓Q3：找不到某个文件怎么办？
Django 不会自动生成所有文件（比如 urls.py）。你需要手动创建并按照格式填写内容。
❓Q4：我该在哪里调试代码？
推荐使用以下方式：
- 使用 print 输出调试信息
- 安装 PyCharm 或 VS Code 插件进行断点调试
- 查看终端日志中的错误信息，针对性修复
六、学习建议：下一步可以学什么？
恭喜你迈出了学习 Django 的第一步！接下来看看可以怎么深入学习：
推荐路线图：
| 阶段 | 学习内容 |
|---|---|
| 初级阶段 | - 使用模板渲染 HTML 页面 - 创建模型与数据库交互 |
| 进阶阶段 | - 用户登录、表单提交 - REST API 接口设计 |
| 高级阶段 | - 部署网站到线上服务器 - 性能优化与安全策略 |
推荐学习资源：
- 👩💻 官方文档：https://docs.djangoproject.com
- 📘 图书《Django企业开发实战》
- 🔍 B站课程搜索 “Django零基础教学”
- 🧪 练手平台：LeetCode，练习数据库查询和接口开发
结语
通过这篇入门教程，你已经学会了：
- 如何搭建 Django 开发环境
- 如何创建项目和 App
- 如何定义 View 和 URL
- 如何写出第一个页面
这只是 Django 强大功能的冰山一角。继续努力，你也可以做出属于自己的强大网站！
🚀 加油！让我们一起开启 Web 开发之旅！
评论 0