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

大模型修路人

2025-06-13 23:17

阅读 689

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

你有没有想过自己也能做一个网站？就像淘宝、知乎或者豆瓣那样的网页？其实，只要掌握了正确的方法，每个人都能做到！

今天我们要学习的 Django 就是一个可以帮助你快速创建网站的 Python 工具。它被称为“全栈 Web 框架”，听起来很高大上，其实你可以把它想象成一个帮你搭房子的工具箱。

有了这个工具箱，你就不用从头写每一个螺丝和砖头——比如数据库怎么连、用户怎么登录、后台怎么管理等等这些复杂的事情，Django 基本都替你想好了。

Django 的优点有哪些？

✅ 免费开源
✅ 语法简洁、开发效率高
✅ 内置功能丰富（比如后台管理、用户认证）
✅ 社区活跃，遇到问题容易找到解决方案
✅ 适合新手入门，也适合企业级开发

一句话总结：用 Python 写网站，选 Django 绝对没错！

环境准备：准备好你的“工作台”

在开始搭建网站之前，我们需要先设置好我们的开发环境。别担心，步骤很清晰，跟着一步步来就行！

第一步：安装 Python

Django 是基于 Python 的框架，所以第一步你需要安装 Python。目前推荐使用 Python 3.8 到 3.11 之间的版本。

如何检查是否已安装？

打开终端（Windows 用 CMD 或 PowerShell，Mac/Linux 用终端）输入：

python --version

如果显示类似 Python 3.x.x，说明已经安装好了。

如果没有安装，请前往 Python 官网下载并安装对应系统的版本。

⚠️ Windows 用户记得勾选“Add to PATH”选项，这样命令才能被识别。

第二步：安装虚拟环境 Virtualenv（可选但推荐）

虚拟环境就像是你在电脑里搭建了一个独立的小房间，专门用来运行你的项目，不会和其他项目的代码冲突。

安装 virtualenv：

pip install virtualenv

创建一个虚拟环境（假设叫 myproject_env）：

virtualenv myproject_env

进入虚拟环境：

Windows：
```
myproject_env\Scripts\activate
```
Mac/Linux：
```
source myproject_env/bin/activate
```

现在你应该看到命令行前面出现了 (myproject_env)，表示进入了虚拟环境。

第三步：安装 Django

在虚拟环境中安装 Django：

pip install django

验证是否安装成功：

django-admin --version

如果能看到版本号（如 4.2.5），那就说明安装成功了！

总结一下当前准备的内容：

步骤	内容
1	安装 Python
2	可选安装 virtualenv 创建虚拟环境
3	在虚拟环境中安装 Django

现在我们万事俱备，只差开始动工了！

核心概念：了解 Django 的“零件”

Django 虽然强大，但理解它的核心结构并不难。我们可以把 Django 看作一个网站工厂，里面有几个主要车间（组件）：

1. Project（项目）

这是整个网站的容器，相当于整栋楼的蓝图。你可以理解为整个网站的大框架。

2. App（应用）

在一个项目中可以有多个 app。比如一个博客网站可能有“文章内容”、“评论系统”、“用户注册”等多个模块，每个模块就是一个 App。

3. Model（模型）

用来定义数据如何存储，比如文章、用户、订单等等。它最终会变成数据库中的表格。

4. View（视图）

决定了用户访问某个网址时看到的内容。你可以把它看作是页面的“业务逻辑”。

5. Template（模板）

就是网页的样子，也就是 HTML 页面。你可以在这里写漂亮的网页结构。

6. URL Routing（路由）

负责把网址和对应的 View 关联起来。比如访问 /about 就跳转到关于我们页面。

举个例子说明一下它们的关系：

比如你想做一个博客系统：

创建一个 Project → 博客网站
创建一个 App → blog（管理文章）
在 Model 中定义 Article 表格 → 包含标题、内容、发布时间
在 View 中处理访问主页的逻辑 → 显示所有文章列表
在 Template 中写 HTML 页面 → 显示具体文章内容
URL 路由配置 → 当访问 /blog/ 时显示文章列表页

搞懂这几个部分，你就能构建出完整的网站啦！

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

现在我们正式开始实战项目。我们将创建一个最简单的网站 —— “Hello, World!” 网站，然后逐步扩展功能，让你熟悉整个流程。

第一步：创建一个 Django 项目

在你打算存放代码的目录下执行以下命令：

django-admin startproject hello_project

这会在当前文件夹创建一个名为 hello_project 的项目文件夹。结构如下：

hello_project/
├── manage.py
└── hello_project/
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

manage.py：非常重要的脚本，用来运行各种命令。
settings.py：项目的全局配置。
urls.py：路由配置，决定哪个网址对应哪个页面。

第二步：运行开发服务器

进入项目根目录：

cd hello_project

运行服务器：

python manage.py runserver

你会看到类似下面的信息：

Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

这时，你可以打开浏览器，访问地址 http://localhost:8000，看到默认的 Django 欢迎页面啦！

第三步：创建一个页面展示 "Hello, World!"

接下来，我们要添加一个新页面，当访问 /hello/ 时显示 “Hello, World!”

1. 创建一个应用（app）

执行命令创建一个新的应用（例如叫做 core）：

python manage.py startapp core

此时项目目录下多了一个 core 文件夹。

打开 hello_project/settings.py 文件，找到 INSTALLED_APPS 部分，将 'core' 添加进去，让 Django 知道我们新增了一个应用：

INSTALLED_APPS = [
    ...
    'core',
]

2. 编写视图（view）

打开 core/views.py 文件，写入以下代码：

from django.http import HttpResponse

def hello_world(request):
    return HttpResponse("Hello, World!")

这表示当这个函数被访问时，就会返回一段文字给浏览器。

3. 配置 URL 路由

在 core 目录下新建一个文件 urls.py（用于配置该应用下的子路由）：

# core/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('', views.hello_world),
]

接下来，在项目主路由 hello_project/urls.py 中引入 core.urls：

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

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello/', include('core.urls')),
]

这段代码的意思是：当访问 /hello/ 时，就去查看 core.urls 中的配置。

4. 测试页面

再次运行服务：

python manage.py runserver

然后访问地址 http://localhost:8000/hello/，你就能看到熟悉的 “Hello, World!” 文字啦！

第四步：加入一个 HTML 页面（模板）

现在我们想把文字换成更美观的网页形式。

1. 创建 templates 文件夹

在 core 应用中创建文件夹结构如下：

core/
├── templates/
│   └── core/
│       └── home.html

在 home.html 中输入：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hello Page</title>
</head>
<body>
    <h1>Welcome to My First Website!</h1>
    <p>Hello, World! This is powered by Django.</p>
</body>
</html>

2. 修改视图，渲染模板

修改 views.py：

from django.shortcuts import render

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

刷新浏览器，你会发现页面变成了 HTML 渲染后的效果！

常见问题：新手常见问题解答

❓ Q1：为什么运行 manage.py 报错？

可能是没有激活虚拟环境或依赖没装全。

✅ 解决办法：

确保虚拟环境处于激活状态；
执行 pip install -r requirements.txt 安装所需的依赖包（如有）。

❓ Q2：为什么不能访问 localhost:8000？

有时候服务器启动失败或端口被占用。

✅ 解决办法：

查看是否有错误信息；
尝试用不同的端口号启动，比如：
```
python manage.py runserver 8080
```

❓ Q3：HTML 页面不生效怎么办？

Django 对模板路径有一定要求，需确保命名和路径一致。

✅ 解决办法：

确认模板文件位于 templates/app_name/file.html 结构内；
检查视图函数的参数是否正确传入模板名；
模板名称区分大小写，必须完全匹配。

❓ Q4：如何退出虚拟环境？

很简单，在终端输入：

deactivate

即可退回到全局 Python 环境。

学习建议：下一步学什么？

你现在已经拥有了搭建简单网页的能力，恭喜迈出第一步！接下来可以沿着以下几个方向继续学习：

📚 推荐进阶主题：

✅ 使用数据库（如 MySQL、PostgreSQL）
✅ 设计表单（Form）和处理用户输入
✅ 实现用户登录与权限管理
✅ 使用静态资源（CSS、JS）
✅ 部署上线（部署到云服务器）

🛠 推荐练习项目（由浅入深）：

🧾 构建一个简易的博客系统
📒 创建带搜索功能的知识库
🧑‍💼 实现一个个人简历网页
📈 构建一个任务管理系统
💬 添加聊天机器人功能

🌐 学习资料推荐：

官方文档（中文翻译版）：Django 官方指南
视频课程平台：B站、YouTube 上搜索关键词 “Django 新手教程”
书籍推荐：《Django for Beginners》《流畅的Python》

总结一下今天的收获！

今天我们从零开始完成了 Django 网站的搭建流程，包括：

步骤	内容
✅ 准备开发环境	Python + Virtualenv + Django
✅ 了解 Django 核心结构	Project、App、View、Template、Model、URL
✅ 实战操作	搭建 Hello World 页面、使用模板 HTML
✅ 遇到了常见问题	启动失败、页面无变化等
✅ 得到了学习建议	如何进一步深入学习和拓展功能

坚持下去，很快你就能做出一个属于自己的完整网站！

🎉 如果你觉得这篇教程对你有帮助，不妨尝试跟着再做一遍，或者试着扩展功能，比如加一个菜单栏、改一个背景颜色，慢慢你会发现：编程真的是一件很有成就感的事！

继续加油，未来可期！🚀

标签:Python开发心得区块链技术分享

最热最新

暂无评论

为你推荐

暂无相关推荐

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

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

Django 的优点有哪些？

环境准备：准备好你的“工作台”

第一步：安装 Python

如何检查是否已安装？

第二步：安装虚拟环境 Virtualenv（可选但推荐）

第三步：安装 Django

总结一下当前准备的内容：

核心概念：了解 Django 的“零件”

1. Project（项目）

2. App（应用）

3. Model（模型）

4. View（视图）

5. Template（模板）

6. URL Routing（路由）

举个例子说明一下它们的关系：

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

第一步：创建一个 Django 项目

第二步：运行开发服务器

第三步：创建一个页面展示 "Hello, World!"

1. 创建一个应用（app）

2. 编写视图（view）

3. 配置 URL 路由

4. 测试页面

第四步：加入一个 HTML 页面（模板）

1. 创建 templates 文件夹

2. 修改视图，渲染模板

常见问题：新手常见问题解答

❓ Q1：为什么运行 manage.py 报错？

❓ Q2：为什么不能访问 localhost:8000？

❓ Q3：HTML 页面不生效怎么办？

❓ Q4：如何退出虚拟环境？

学习建议：下一步学什么？

📚 推荐进阶主题：

🛠 推荐练习项目（由浅入深）：

🌐 学习资料推荐：

总结一下今天的收获！

评论 0

为你推荐

相关推荐

精选内容