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

慢查询猎人

2025-06-28 09:59

阅读 448

🌐 开篇：Django 是什么？我能用它做什么？

你是不是也听说过“Python做网站”这个说法，但又觉得它离自己很远？其实呀，Django 就是你通往网站开发世界的一把钥匙！

✅ 什么是 Django？

Django 是一个用 Python 写的 Web框架。你可以把它理解为一套已经帮你搭好结构的房子，你只需要往里面装修，就能快速建出一个完整的网站。

📚 类比一下：
如果你想象建一栋房子，那么普通编程就像从烧砖开始；而使用 Django，则像是开发商已经给你盖好了地基、墙体、水电，你只需装修和布置家具就行了。

💡 你能用 Django 做什么？

做个人博客
搭建电商平台
创建内容管理系统（CMS）
构建企业级后台系统
制作论坛、社交网络等复杂应用

总之，你想做的大多数网页功能，Django都能帮你实现，而且速度非常快！

🛠 环境准备：搭建属于你的编程舞台

在写代码之前，我们需要先准备好“表演”的舞台——也就是开发环境。下面我们将一步步安装所需工具，并验证是否成功。

⚠️ 提示：以下操作适用于 Windows、MacOS 和 Linux 用户，请根据自己的系统选择命令行工具（如 Terminal 或 CMD）执行命令。

步骤一：安装 Python

Django 是基于 Python 的框架，所以首先我们得确认电脑上有没有安装 Python。

打开终端或命令提示符，输入：

python --version

或者对于部分系统是：

python3 --version

如果看到类似 Python 3.8.x 这样的输出，说明你已经装了 Python！

如果没有输出，请去 Python 官网下载并安装最新版本的 Python。

✅ 安装后再次运行上述命令验证。

步骤二：安装 pip

pip 是 Python 的包管理工具，用来安装 Django 等模块。大部分新版本的 Python 已经自带 pip。

检查 pip 是否可用：

pip --version

如果你看到版本号（例如 pip 23.0），那就可以继续下一步啦！

步骤三：安装 Django

终于到关键一步了！我们使用 pip 安装 Django：

pip install django

等待几秒钟，安装完成后可以用下面这条命令查看 Django 版本：

django-admin --version

你会看到类似这样的一串数字：4.2.5（具体数字可能不同）。恭喜！你现在拥有 Django 了！

🧩 核心概念讲解：Django 中的“骨架”

为了让你更好地理解接下来的内容，我们先来认识几个最核心的概念。

服务器部署方案-2

🔹 项目 Project vs 应用 App

在 Django 中有两个最基本的东西：

名词	含义	比喻
Project（项目）	整个网站的大框架，包含多个 App	就像整个房屋建筑结构
App（应用）	具体的功能模块，比如博客、用户登录等	就像每个房间（客厅、厨房）

📌 新手注意：一个项目可以有多个 app，app之间相互协作，共同完成网站功能。

🔹 URL 配置（urls.py）

URL 路由就像是电话分机号码。当你访问某个网址时（比如 www.example.com/about），网站需要知道该让哪个程序处理这个请求。

我们就是在这个文件里设置这些“分机”。

🔹 视图 Views.py

Views（视图）就像服务员，接收顾客点单（浏览器请求），然后联系厨师（逻辑层）上菜（返回网页）。

我们会在这里写 Python 函数或类，决定显示哪些内容。

🔹 模板 Templates

Templates（模板）是 HTML 文件，用于美化页面内容。它们可以被视图调用，填充数据后展示给用户。

举个例子：我们可以写一个 HTML 页面叫做 home.html，然后从 views.py 加载它并填入标题“我的首页”。

🔹 数据库模型 Models.py

Models（模型）相当于数据库设计图纸。你可以定义一些 Python 类来表示数据表，比如：

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()

这代表我们要创建一个叫 Post 的数据表，包含标题和内容两个字段。

🧑‍🏫 实战项目：搭建一个简单的小网站

现在我们一起来创建一个简单的博客网站，叫做 “MySite”。它将包含主页，欢迎语和一个关于页面。

第一步：创建 Django 项目

进入你喜欢的工作目录（例如桌面），运行以下命令：

django-admin startproject MySite

这会在当前目录生成一个名为 MySite 的文件夹。里面有如下文件结构：

MySite/
├── manage.py            # 管理工具脚本
└── MySite/              # 项目配置文件
    ├── __init__.py      # 包初始化
    ├── settings.py      # 配置中心
    ├── urls.py          # 主路由文件
    └── wsgi.py          # 服务器部署相关

第二步：启动本地服务器测试站点

进入项目根目录后运行：

cd MySite
python manage.py runserver

然后打开浏览器访问 http://localhost:8000，你应该会看到默认的欢迎页面。

🎉 成功了！你的第一个 Django 网站跑起来了！

第三步：创建一个 App 叫 blog

接下来我们添加一个功能模块：blog（博客）。

python manage.py startapp blog

你会发现多了一个 blog 文件夹，其中包含：

blog/
├── admin.py         # 管理后台注册
├── apps.py
├── migrations/      # 数据库迁移历史
├── models.py        # 数据模型
├── tests.py         # 单元测试
└── views.py         # 处理网页请求

别忘了把这个 app 注册到项目中：

打开 MySite/settings.py 文件，在 INSTALLED_APPS 列表中加入：

'blog',

第四步：编写第一个视图 view 和页面

打开 blog/views.py，添加：

from django.http import HttpResponse

def home(request):
    return HttpResponse("你好，这是我的博客主页！")

接着，我们还要配置 url 来连接这个视图：

新建 blog/urls.py 并加入：

from django.urls import path
from . import views

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

然后编辑主路由文件 MySite/urls.py：

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

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

保存后重启服务器：

python manage.py runserver

打开 http://localhost:8000，这次你应该能看到我们写的文字了！

第五步：用模板美化页面

接下来，让我们把纯文本升级成美观的 HTML 页面。

在 blog 目录下创建 templates/blog/ 文件夹，并新建文件 home.html：

blog/
└── templates/
    └── blog/
        └── home.html

在 home.html 中写入：

<!DOCTYPE html>
<html>
<head>
    <title>我的博客</title>
</head>
<body>
    <h1>欢迎来到我的博客！</h1>
    <p>这是一个使用 Django 搭建的简单网站。</p>
</body>
</html>

修改 views.py：

from django.shortcuts import render

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

刷新页面看看效果吧！👏

❓常见问题解答

Q1：为什么运行 `runserver` 报错说端口被占用？

A：可能是上次服务器没有关闭。请尝试按下 Ctrl+C 结束旧进程，再重新运行。

Q2：找不到 ‘manage.py’ 文件怎么办？

A：确保你在项目的根目录（即包含 manage.py 的那个文件夹）下运行命令。

Q3：HTML 文件没变化，刷新也没反应？

A：尝试清除浏览器缓存，或者换一个无痕模式打开网页试试。

Q4：忘记加逗号导致报错怎么办？

A：Python 对格式要求严格，特别是逗号和缩进。建议使用专业的编辑器（如 VSCode、PyCharm）会有语法高亮提示错误。

🚀 学习路径建议：从零开始走向高手之路

恭喜你完成了第一篇实战教程！接下来你可以按照以下路径继续提升：

✅ 推荐学习顺序：

深入视图与模板
- 学习传参、动态页面
- 使用 {% for %}、变量展示数据
数据库基础与模型
- 定义 Model，插入查询数据
- 使用 ORM（对象关系映射）替代 SQL
表单交互
- 使用 forms.Form 和 ModelForm
- 收集用户输入，保存到数据库
静态文件管理（CSS / JS / 图片）
- 设置 static 目录
- 引入 Bootstrap 等前端框架
项目部署到线上
- 学会使用 gunicorn + Nginx
- 使用免费平台如 Heroku、Render 部署你的网站

📚 推荐资源：

官方文档: https://docs.djangoproject.com/zh-hans/stable/
中文社区教程: https://code.ziqiangxuetang.com/django/
Bilibili 视频教学推荐：搜索“Django 零基础教程”
书籍推荐：
- 《Django企业开发实战》
- 《流畅的Python》（帮助提高基础能力）

数据流转过程-1

📌 总结回顾

在这篇文章中，我们一步步完成了：

✅ Django 环境搭建
✅ 创建第一个项目和 App
✅ 编写了简单的页面逻辑
✅ 使用模板优化页面展示
✅ 解决了一些常见新手问题
✅ 推荐了后续学习方向

希望这篇入门教程能点燃你对 Web 开发的热情！记住，实践才是最好的老师。只要你愿意动手敲每一行代码，未来一定能成为一名优秀的后端工程师！

🎯 小练习题（自测巩固）：

如何创建一个新的 Django 应用？
在哪里添加应用到项目中？
如何创建一个显示 “Hello World!” 的页面？
模板应该放在哪里？
如果想创建一个 about.html 页面，如何让它在 /about 路径下显示？

下次再见！继续加油哦！💻✨

标签:爬虫Springboot求职

最热最新

暂无评论

为你推荐

暂无相关推荐

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

🌐 开篇：Django 是什么？我能用它做什么？

✅ 什么是 Django？

💡 你能用 Django 做什么？

🛠 环境准备：搭建属于你的编程舞台

步骤一：安装 Python

步骤二：安装 pip

步骤三：安装 Django

🧩 核心概念讲解：Django 中的“骨架”

🔹 项目 Project vs 应用 App

🔹 URL 配置（urls.py）

🔹 视图 Views.py

🔹 模板 Templates

🔹 数据库模型 Models.py

🧑‍🏫 实战项目：搭建一个简单的小网站

第一步：创建 Django 项目

第二步：启动本地服务器测试站点

第三步：创建一个 App 叫 blog

第四步：编写第一个视图 view 和页面

第五步：用模板美化页面

❓常见问题解答

Q1：为什么运行 `runserver` 报错说端口被占用？

Q2：找不到 ‘manage.py’ 文件怎么办？

Q3：HTML 文件没变化，刷新也没反应？

Q4：忘记加逗号导致报错怎么办？

🚀 学习路径建议：从零开始走向高手之路

✅ 推荐学习顺序：

📚 推荐资源：

📌 总结回顾

评论 0

为你推荐

精选内容

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

🌐 开篇：Django 是什么？我能用它做什么？

✅ 什么是 Django？

💡 你能用 Django 做什么？

🛠 环境准备：搭建属于你的编程舞台

步骤一：安装 Python

步骤二：安装 pip

步骤三：安装 Django

🧩 核心概念讲解：Django 中的“骨架”

🔹 项目 Project vs 应用 App

🔹 URL 配置（urls.py）

🔹 视图 Views.py

🔹 模板 Templates

🔹 数据库模型 Models.py

🧑‍🏫 实战项目：搭建一个简单的小网站

第一步：创建 Django 项目

第二步：启动本地服务器测试站点

第三步：创建一个 App 叫 blog

第四步：编写第一个视图 view 和页面

第五步：用模板美化页面

❓常见问题解答

Q1：为什么运行 runserver 报错说端口被占用？

Q2：找不到 ‘manage.py’ 文件怎么办？

Q3：HTML 文件没变化，刷新也没反应？

Q4：忘记加逗号导致报错怎么办？

🚀 学习路径建议：从零开始走向高手之路

✅ 推荐学习顺序：

📚 推荐资源：

📌 总结回顾

评论 0

为你推荐

相关推荐

精选内容

Q1：为什么运行 `runserver` 报错说端口被占用？