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

技术森林

2025-06-23 01:58

阅读 585

开篇：Django 是什么？

你可能听说过 Python 是一门非常适合初学者的编程语言，那你知道它还能用来做网站吗？今天我们要介绍的是一个叫 Django 的工具，它可以帮助你用 Python 快速地搭建出功能强大的网站。

Django 是一个基于 Python 的 Web 框架（Web Framework）。说得简单一点，框架就是别人帮你写好的一套工具和结构，让你不需要从零开始造轮子。你可以专注于实现功能，而不是重复劳动。比如你想做个博客网站，Django 已经帮你写好了用户登录、数据库操作等功能的基础代码，你只需要按照它的规则进行扩展就可以了。

本教程的目标是带领你一步步使用 Django 做出一个简单的网站，哪怕你以前完全没有接触过网站开发也没关系！

环境准备：准备好我们的开发环境

数据流转过程-1

环境准备：准备好我们的开发环境

在开始写代码之前，我们需要先在你的电脑上安装必要的软件。

步骤1：安装 Python

Django 是用 Python 写的，所以第一步你需要安装 Python。

Windows 用户：

访问官网 https://www.python.org/downloads/
点击“Download Python”按钮下载安装包。
安装时记得勾选 “Add to PATH” 选项。
安装完成后，在命令行运行：
```
python --version
```
如果能看到类似 Python 3.12 的输出说明安装成功了。

macOS / Linux 用户：

Python 可能已经自带了，但建议安装最新版本。可以用 Homebrew（macOS）或 apt-get（Ubuntu）等工具管理安装。

步骤2：创建虚拟环境（推荐）

为了不让不同项目的依赖互相干扰，我们通常会使用虚拟环境来隔离项目。

在命令行中执行以下命令：

python -m venv my_env

这个命令会在当前目录下创建一个叫做 my_env 的文件夹，这就是你的虚拟环境。

激活虚拟环境：

Windows：
```
my_env\Scripts\activate
```
macOS/Linux：
```
source my_env/bin/activate
```

激活后，命令行前会出现 (my_env) 表示你现在在这个虚拟环境中工作。

步骤3：安装 Django

在虚拟环境激活的状态下，运行以下命令安装 Django：

pip install django

安装完成后可以查看安装是否成功：

django-admin --version

如果显示 Django 版本号，说明安装成功。

核心概念：理解几个关键名词

在正式开始写项目前，先了解一些 Django 中的核心概念，这样后面学起来就更容易了。

1. MVT 架构模式（Model-View-Template）

Django 使用的是一个叫做 MVT 的架构模式。你可以把它想象成一个分工明确的团队：

Model（模型）：负责处理数据，比如把文章存到数据库里。
View（视图）：负责处理逻辑和请求，比如当用户访问首页时显示哪些内容。
Template（模板）：负责展示页面，也就是 HTML 页面。

虽然名字看起来和常见的 MVC 不太一样，但这只是命名方式上的区别，并不影响使用。

2. 什么是项目和应用？

在 Django 中，项目（Project） 就是整个网站的大框架，它可以包含多个 应用（App）。

举个例子：

项目 = 一个完整的电商网站。
应用 = 商品模块、用户模块、购物车模块等等。

这样的设计可以让代码结构更清晰，方便管理和维护。

3. 什么是 URL 路由？

路由（Routing）就像地图上的导航路线。当你在浏览器输入网址，比如 http://example.com/about/，Django 需要知道该显示哪个页面。这时候就需要靠 URL 配置文件（urls.py） 来指定每个网址对应哪个函数或页面。

实战项目：动手做一个最简单的网站

现在我们来写一个超级简单的网页，目标是让浏览器访问某个地址时显示一段文字：“欢迎来到我的第一个 Django 网站！”

第一步：创建项目

打开命令行，进入你想存放项目的文件夹（比如桌面），然后执行：

django-admin startproject mysite

这条命令会在当前目录下生成一个名为 mysite 的项目文件夹。

进入这个文件夹：

cd mysite

现在的目录结构大概是这样的：

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

其中最重要的两个文件是：

manage.py：这是管理整个项目的脚本。
settings.py：配置文件，比如数据库设置、应用列表等。

第二步：启动服务器预览网站

我们先看看默认的站点是什么样的。

执行以下命令：

python manage.py runserver

你会看到类似下面的输出：

Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

现在打开浏览器访问这个地址：http://127.0.0.1:8000/，你应该能看到一个写着“Welcome to Django”的页面。

按下 Ctrl + C 终止服务器。

第三步：创建第一个应用

接下来我们要添加一个自己的页面。首先创建一个应用：

python manage.py startapp hello

现在你的项目结构应该像这样：

mysite/
├── manage.py
├── hello/         ← 新的应用
└── mysite/

别忘了在 mysite/settings.py 文件中注册这个新应用：

找到 INSTALLED_APPS 列表，添加一行 'hello.apps.HelloConfig'：

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

保存文件。

第四步：写一个简单的视图函数

打开 hello/views.py 文件，添加以下代码：

from django.http import HttpResponse

def index(request):
    return HttpResponse("欢迎来到我的第一个 Django 网站！")

这段代码定义了一个函数 index，当有人访问特定页面时，返回一句问候语。

第五步：配置 URL 路由

为了让访问路径能正确匹配到刚刚写的函数，我们需要配置 URL 路由。

在 hello 目录下新建一个文件：urls.py
写入如下内容：

from django.urls import path
from . import views

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

这表示访问 / 路径（即空路径）时调用 views.index 函数。

然后还需要在主项目中引入这个应用的路由信息：

修改 mysite/urls.py：

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

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

第六步：再次运行服务器并测试

重新运行服务端：

python manage.py runserver

再次访问 http://127.0.0.1:8000/，你会发现页面变成了我们自己写的问候语！

常见问题：新手容易遇到的问题及解决方法

问题1：找不到 manage.py 或 urls.py 文件

✅ 解决方法：请确保你在正确的目录下执行命令。例如运行 runserver 时应位于 mysite 目录内。

问题2：ImportError: No module named ‘hello’

✅ 解决方法：可能是你没有在 INSTALLED_APPS 中正确添加新应用的名称，请检查拼写和格式。

问题3：页面空白或报错 404

✅ 解决方法：检查你的 URL 配置是否正确，或者是否有拼写错误。同时注意浏览器访问的地址是否加了斜杠（有些情况会影响结果）。

问题4：Django 报错提示 “You have unapplied migrations…”

✅ 解决方法：这是正常现象，因为 Django 自带了一些数据库表用于内置功能，我们需要运行迁移：

python manage.py migrate

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

恭喜你完成了第一个 Django 小项目！这只是冰山一角，还有更多有趣的内容等着你去探索。

以下是适合你继续学习的方向：

1. 学习模板系统（Templates）

现在我们只用了最基础的 HttpResponse 输出纯文本，其实 Django 支持将 HTML 文件作为模板，让你轻松构建漂亮的页面。

推荐尝试：

<h1>{{ message }}</h1>

2. 使用数据库和模型（Models）

你可以为你的网站添加数据库支持，比如存储用户留言、文章等内容。

3. 学习表单（Forms）

学会让用户通过表单提交信息，比如评论框、登录框等。

4. 学习 Admin 后台管理界面

Django 提供了一个非常强大又易用的后台管理系统，可以直接对数据库中的数据进行增删改查。

结语

通过这篇教程，你已经掌握了使用 Django 创建网站的基本流程，学会了创建项目、编写视图、配置路由等基础知识。虽然我们只是一个最简单的网页，但这已经为你打下了坚实的基础！

继续加油，未来你可以做出更复杂的网站，比如个人博客、论坛、甚至电商平台。记住一句话：编程最重要的是“多动手、多练习”。

如果你在学习过程中有任何疑问，也欢迎随时提问，祝你在 Django 学习之旅中一路顺风！🌟

标签:后端资源Python

最热最新

暂无评论

为你推荐

暂无相关推荐

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

开篇：Django 是什么？

环境准备：准备好我们的开发环境

步骤1：安装 Python

Windows 用户：

macOS / Linux 用户：

步骤2：创建虚拟环境（推荐）

步骤3：安装 Django

核心概念：理解几个关键名词

1. MVT 架构模式（Model-View-Template）

2. 什么是项目和应用？

3. 什么是 URL 路由？

实战项目：动手做一个最简单的网站

第一步：创建项目

第二步：启动服务器预览网站

第三步：创建第一个应用

第四步：写一个简单的视图函数

第五步：配置 URL 路由

第六步：再次运行服务器并测试

常见问题：新手容易遇到的问题及解决方法

问题1：找不到 manage.py 或 urls.py 文件

问题2：ImportError: No module named ‘hello’

问题3：页面空白或报错 404

问题4：Django 报错提示 “You have unapplied migrations…”

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

1. 学习模板系统（Templates）

2. 使用数据库和模型（Models）

3. 学习表单（Forms）

4. 学习 Admin 后台管理界面

推荐学习资源：

结语

评论 0

为你推荐

精选内容