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

技术慢生活

2025-06-14 17:03

阅读 720

一、Django是什么？它能用来做什么？

在开始编程之前，我们先来了解一下我们将要使用的工具：Django。

✨ Django 是什么？

Django 是一个用 Python 编写的 Web 框架。它的核心目标是帮助开发者快速构建功能完善的网站。你可以把它想象成是一个“建站工具箱”，里面有很多已经写好的模块，你只需要按照自己的需求“组装”即可。

💡 它能用来做什么？

博客系统
在线商城
社交网站
内部管理系统（比如OA）
后台 API 接口服务

很多大公司，比如 Instagram 和 Pinterest 都使用 Django 构建网站后端。

二、环境准备：从零开始搭建开发环境

在开始写代码之前，我们需要准备好开发环境。本节我们将一步步完成以下内容：

安装 Python
安装 pip 工具
安装 Django
创建项目目录结构

🛠️ 第一步：安装 Python

说明：Django 只能在 Python 环境下运行。如果你的电脑上还没安装 Python，请先到官网下载并安装：

https://www.python.org/downloads/

安装时注意勾选 “Add to PATH” 这个选项。

安装完成后，在命令行中输入：

python --version

你应该会看到类似这样的输出（版本号可能不同）：

Python 3.10.4

🔧 第二步：安装 pip

pip 是 Python 的包管理工具。我们可以用它来安装 Django。大多数情况下，Python 安装包里已经自带了 pip。

验证是否已安装 pip：

pip --version

如果显示如下信息，表示安装成功：

pip 23.0.1 from ... (python 3.10)

如果没有安装，可以参考官方文档或直接运行下面这行命令安装：

python -m ensurepip --upgrade

📦 第三步：安装 Django

接下来，我们正式安装 Django。

打开命令行工具，运行：

pip install django

等待几分钟，pip 会自动下载并安装 Django。

安装完成后，检查一下是否安装成功：

django-admin --version

你会看到 Django 的版本号，例如：

4.2.1

📁 第四步：创建项目目录

为了组织代码，我们先新建一个项目文件夹。

以 myfirstsite 为例，执行以下步骤：

mkdir myfirstsite
cd myfirstsite

然后使用 Django 提供的工具生成基础项目结构：

django-admin startproject mysite .

这里有个点要注意：最后面的句号（.）很重要！ 它的意思是把项目生成在这个目录下，而不是额外再创建一个子文件夹。

完成后你会看到目录结构如下：

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

三、Django 核心概念解析（小白也能懂）

刚接触 Django，你可能会听到一些专业名词，比如 视图、模型、模板、URL路由、应用，别担心，我用最简单的话解释给你听。

名词	白话解释
应用（App）	网站中的一个小模块，比如博客、留言簿
模型（Model）	数据库的结构设计，比如“用户表”、“文章表”等
视图（View）	处理逻辑的部分，比如接收请求、操作数据库
模板（Template）	HTML 页面，用于展示数据
URL 路由（Url）	把网址和视图关联起来，告诉 Django 访问哪个页面执行哪段代码

🎯 举个小例子：

假设你要做一个“博客网站”。

创建一个 app 叫做 blog （就是一个模块）
Blog 模块里面有 Model：“文章”这个数据结构
View 就是你看到网页背后的处理程序（读取文章内容、返回给前端）
Template 是文章页面的 HTML 模板
URL 把访问路径 /blog/1 对应到查看某篇文章的 View

四、实战项目：打造第一个 Django 网站

现在我们来一步步创建我们的第一个网站。目标是创建一个欢迎页面，显示一句话：“你好，欢迎来到我的网站！”

Step 1：启动开发服务器

回到终端，运行：

python manage.py runserver

你应该会在控制台看到类似这样的信息：

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

浏览器打开：http://127.0.0.1:8000/
你会看到默认的欢迎页面：

✅ “Welcome to Django! It worked.”

恭喜，你已经成功运行了一个 Django 网站！

Step 2：创建一个 App（应用）

我们要为首页添加内容，所以需要创建一个专门的应用。继续在终端运行：

python manage.py startapp home

这会生成一个叫做 home 的新文件夹，它是一个独立的功能模块。

然后我们把这个 app 注册到 Django 中。

打开 mysite/settings.py 文件，找到 INSTALLED_APPS 列表，并添加 'home'：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'home',  # 添加这一行
]

保存文件。

Step 3：编写视图函数

打开 home/views.py 文件，清空里面的内容，替换成如下代码：

from django.http import HttpResponse

def index(request):
    return HttpResponse("你好，欢迎来到我的网站！")

这段代码的作用是：当有人访问某个网页时，返回一段文字。

Step 4：配置 URL 路由

Django 是通过 URL 来决定谁来处理用户的请求的。

打开主项目的 URL 配置文件 mysite/urls.py，修改如下：

from django.contrib import admin
from django.urls import path
from home import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.index),  # 主页
]

这里的 ' ' 表示根路径，也就是访问 http://127.0.0.1:8000/ 时就会触发 views.index。

Step 5：重启服务器测试

在终端按下 Ctrl + C 停止服务器，重新运行：

python manage.py runserver

再次访问主页，你会发现文字变了：

✅ 输出结果：“你好，欢迎来到我的网站！”

🎉 成功了！

五、常见问题解答（Q&A）

作为新手，在学习过程中你可能会遇到一些常见问题，以下是几个典型情况及解决方法。

❓ 问题1：提示 `No module named 'django'` 怎么办？

原因： Django 没有正确安装或者没有被识别。

解决方法：

重新执行安装命令 pip install django
如果你使用的是虚拟环境，请确认你在正确的环境中执行命令
使用 pip list 查看已安装包列表是否有 django

❓ 问题2：启动服务器时报错 `address already in use`

原因： 上次运行的服务器没关掉，占用了端口。

解决方法：

用快捷键 Ctrl + C 结束进程
或者换一个端口号启动：
```
python manage.py runserver 8001
```

❓ 问题3：页面访问时出现 Server Error (500)

原因： 代码中有语法错误导致服务器崩溃。

解决方法：

检查你最近修改的代码文件，尤其是 views.py 和 urls.py
重启服务器看是否恢复正常

六、下一步学习建议

恭喜你完成了《Django入门教程》，你已经掌握了：

Django 的基本工作原理
如何创建项目和应用
如何定义 URL 和视图
如何运行服务器测试代码

那么接下来该学什么呢？下面是我为你规划的学习路线：

✅ 学习路线推荐：

静态资源管理（CSS / JS / 图片） → 高级样式和图片显示
模板系统（HTML 页面） → 用 HTML 展示动态内容
模型与数据库（models） → 存储和读取真实数据
管理后台（Admin） → 快速实现数据增删改查
用户登录与权限控制 → 用户系统搭建
部署上线 → 将网站发布到公网
REST API 开发 → 为移动端提供接口

🎯 推荐资源：

Django 官方文档：https://docs.djangoproject.com/en/stable/
Real Python 教程：https://realpython.com/tutorials/django/
《流畅的Python》——深入理解 Python 语言

✅ 小结

这篇文章带着你一步一步从环境搭建到写出第一个页面，全程无死角讲解每个步骤。即使你是完全零基础的新手，也应该能够顺利完成。

记住一点：编程最好的方式就是动手写代码。不要怕犯错，多试几次，你就越来越熟练了。

如果你喜欢这篇文章，欢迎收藏并点赞分享～下一节课我会带大家玩转 Django 的数据库系统，记得关注哟 😊

📌 文章字数统计：约2484字

标签:区块链求职

最热最新

暂无评论

为你推荐

暂无相关推荐

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

一、Django是什么？它能用来做什么？

✨ Django 是什么？

💡 它能用来做什么？

二、环境准备：从零开始搭建开发环境

🛠️ 第一步：安装 Python

🔧 第二步：安装 pip

📦 第三步：安装 Django

📁 第四步：创建项目目录

三、Django 核心概念解析（小白也能懂）

四、实战项目：打造第一个 Django 网站

Step 1：启动开发服务器

Step 2：创建一个 App（应用）

Step 3：编写视图函数

Step 4：配置 URL 路由

Step 5：重启服务器测试

五、常见问题解答（Q&A）

❓ 问题1：提示 `No module named 'django'` 怎么办？

❓ 问题2：启动服务器时报错 `address already in use`

❓ 问题3：页面访问时出现 Server Error (500)

六、下一步学习建议

✅ 学习路线推荐：

✅ 小结

评论 0

为你推荐

精选内容

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

一、Django是什么？它能用来做什么？

✨ Django 是什么？

💡 它能用来做什么？

二、环境准备：从零开始搭建开发环境

🛠️ 第一步：安装 Python

🔧 第二步：安装 pip

📦 第三步：安装 Django

📁 第四步：创建项目目录

三、Django 核心概念解析（小白也能懂）

四、实战项目：打造第一个 Django 网站

Step 1：启动开发服务器

Step 2：创建一个 App（应用）

Step 3：编写视图函数

Step 4：配置 URL 路由

Step 5：重启服务器测试

五、常见问题解答（Q&A）

❓ 问题1：提示 No module named 'django' 怎么办？

❓ 问题2：启动服务器时报错 address already in use

❓ 问题3：页面访问时出现 Server Error (500)

六、下一步学习建议

✅ 学习路线推荐：

✅ 小结

评论 0

为你推荐

相关推荐

精选内容

❓ 问题1：提示 `No module named 'django'` 怎么办？

❓ 问题2：启动服务器时报错 `address already in use`