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

ProductVision

2025-06-28 21:46

阅读 210

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

你好！如果你是第一次听说 Django，那我们先来简单了解一下它是啥。

Django 是一个使用 Python 编写的 Web 框架。它的目标是让你能够快速开发安全、功能强大的网站。你可以把它想象成盖房子的“脚手架”——有了它，你不用从头造轮子，而是可以在现成的基础上更快地构建自己的网站。

比如你想做一个博客、商城、论坛或者任何需要后端逻辑的网页应用，Django 都是一个非常棒的选择！

为什么选择 Django？

✅ 简洁易读的语法（因为它基于 Python）
✅ 内置了数据库操作、用户认证等常见功能
✅ 官方文档丰富，社区活跃
✅ 足够强大，能支撑像 Instagram 这样的大型网站

环境准备：搭建开发环境

服务器部署方案-1

环境准备：搭建开发环境

在写代码之前，我们需要准备好你的开发环境。别担心，这一步其实很简单。

步骤1：安装 Python

Django 是 Python 的框架，所以第一步你需要确保电脑上已经安装了 Python。

如何检查是否已安装？

打开终端（Windows 上是命令提示符或 PowerShell），输入：

python --version

如果输出类似：

Python 3.9.5

说明你已经装好了。否则请去官网下载安装包：
👉 https://www.python.org/downloads/

✅ 注意：请安装 Python 3.x（推荐最新稳定版）

步骤2：安装 Django

接下来我们要通过 pip（Python 自带的包管理工具）来安装 Django。

运行以下命令：

pip install django

等待几秒钟到几分钟（取决于网络速度），安装完成后输入：

django-admin --version

如果能看到版本号，比如 4.2 或类似，那就说明安装成功啦！

步骤3：创建一个项目目录（文件夹）

我们可以专门建一个文件夹存放我们的网站项目。比如叫 my_website。

mkdir my_website
cd my_website

现在我们将在这个文件夹下创建你的第一个 Django 项目。

核心概念：Django 的三大核心组件

在深入编码前，了解几个核心概念是非常有必要的，它们会帮助你更好地理解整个流程。

1. 项目（Project）

可以理解为整个网站的“外壳”，包含全局配置和多个模块（这些模块叫做 App）。就像一本书的封面和目录。

2. 应用（App）

App 是网站的功能单元。比如博客系统是一个 App，留言功能是另一个 App。它们被添加进项目中协同工作。

3. 模型 - 视图 - 模板（MVT 模式）

这是 Django 的架构模式，类似于传统的 MVC 架构。三部分分别是：

名称	描述
Model（模型）	和数据库交互，存储数据
View（视图）	控制网站显示的内容逻辑
Template（模板）	网页的具体样式，HTML 文件

听起来有点抽象？没关系，在实战中你会更直观地理解。

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

我们来动手搭建一个简单的网站吧！最终效果是一个欢迎页面和一个显示当前时间的页面。Let's go！

第一步：创建新项目

进入我们之前的项目文件夹 my_website，然后执行：

django-admin startproject hello_project

这样 Django 就为我们创建了一个项目，结构如下：

hello_project/
│
├── manage.py             # 管理项目的命令入口
└── hello_project/        # 项目主文件夹
    ├── __init__.py       # 表明这是一个 Python 包
    ├── settings.py       # 全局配置文件
    ├── urls.py           # 存放 URL 映射关系
    └── wsgi.py / asgi.py # 部署相关文件

第二步：运行服务器看效果

现在我们运行一下开发服务器看看效果：

cd hello_project
python manage.py runserver

默认会在浏览器地址 http://127.0.0.1:8000 打开一个欢迎页面。

你应该能看到 Django 的经典欢迎页：“The install worked successfully! Congratulations!”

按下 Ctrl + C 停止服务器。

第三步：创建一个新页面 —— 欢迎页

我们现在想要访问 /welcome 这个路径，返回一段欢迎语。

1. 创建一个视图函数（View）

在 hello_project/hello_project/views.py 中添加以下内容：

from django.http import HttpResponse

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

2. 配置 URL 路由

编辑 urls.py 文件，把上面的 welcome 函数绑定到 /welcome：

from django.urls import path
from .views import welcome

urlpatterns = [
    path('welcome/', welcome),
]

再次运行服务器：

python manage.py runserver

打开浏览器访问：http://localhost:8000/welcome

你应该看到文字：“欢迎来到我的第一个 Django 网站！”

🎉 成功！

第四步：再加一个显示当前时间的页面

我们再来加一个页面显示服务器的当前时间。

修改 views.py：

from django.http import HttpResponse
from datetime import datetime

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

def current_time(request):
    now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    return HttpResponse(f"当前服务器时间是：{now}")

添加 URL 映射：

继续修改 urls.py：

from django.urls import path
from .views import welcome, current_time

urlpatterns = [
    path('welcome/', welcome),
    path('time/', current_time),
]

保存之后重启服务并访问：

👉 http://localhost:8000/time

应该可以看到服务器的时间啦！

第五步：使用模板返回 HTML 页面（可选但推荐）

前面的例子用了纯文本返回内容，实际开发中我们通常希望展示 HTML 页面。

1. 创建 templates 目录

在 hello_project 文件夹下新建一个目录：

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

在 templates/home.html 中添加以下 HTML 内容：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
    <h1>欢迎来到我的网站</h1>
    <p>这是通过 Django 模板渲染出来的页面。</p>
</body>
</html>

2. 设置模板路径

修改 settings.py 中的 TEMPLATES 配置部分，添加：

import os

...

TEMPLATES = [
    {
        ...
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        ...
    },
]

3. 使用模板显示页面

修改 views.py：

from django.shortcuts import render

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

更新 urls.py：

path('', home),

重启服务器访问根网址：

👉 http://localhost:8000

你现在应该看到一个带有标题和段落的 HTML 页面。

常见问题与解答

下面是初学者最常遇到的问题和解决办法👇

❓Q1：运行 python manage.py 报错怎么办？

可能出现原因：

忘记在 hello_project 文件夹里执行命令
Python 版本不对（建议使用 Python 3.9+）
路径中存在中文或空格导致路径错误

📌 解决方法：检查所在目录、重命名文件夹为英文、重新安装 Django。

❓Q2：URL 访问一直 404 错误

可能因为你没有将新 URL 加入 urlpatterns 列表，或者路径拼错了（例如少斜杠 /）。

📌 检查步骤：

是否正确导入视图函数
是否忘记加逗号或引号
地址栏中的 URL 是否拼写完全匹配

❓Q3：改完代码看不到变化怎么办？

因为 Django 开发服务器不会自动刷新，请停止服务器并重新启动一次：

Ctrl + C  # 停止
python manage.py runserver  # 启动

❓Q4：能不能换一个端口运行服务器？

当然可以，默认是 8000。如果冲突可以改成其他数字：

python manage.py runserver 8080

访问地址就变成了：http://localhost:8080

学习建议：下一步我可以学什么？

恭喜你完成了你的第一个 Django 网站！这只是刚刚开始 😄

下面是一些你可以继续学习的方向：

📚 推荐学习路线图：

学习静态文件处理（CSS / JS / 图片）
使用数据库（ORM）
创建后台管理界面 admin
用户登录注册功能
部署上线（如使用 Nginx + Gunicorn）

🧠 学习资源推荐：

👉 Django 官方文档中文版
👉 菜鸟教程 Django 教程
👉 《Django企业开发实战》书籍入门章节

总结一下

在这篇文章中我们：

了解了什么是 Django 及其用途
搭建了完整的开发环境
学习了项目结构和 MVT 模式
动手创建了三个页面（欢迎页、时间页、模板页）
解决了一些新手常见的报错问题

只要你继续练习、动手实践，很快就可以用 Django 做出属于自己的完整网站啦！

如果你喜欢这篇文章，别忘了点赞、收藏，也欢迎继续关注我后续更新的 Python 与 Web 开发系列文章！

🎯 Happy Coding！

标签:简历爬虫Python

最热最新

暂无评论

为你推荐

暂无相关推荐

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

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

为什么选择 Django？

环境准备：搭建开发环境

步骤1：安装 Python

如何检查是否已安装？

步骤2：安装 Django

步骤3：创建一个项目目录（文件夹）

核心概念：Django 的三大核心组件

1. 项目（Project）

2. 应用（App）

3. 模型 - 视图 - 模板（MVT 模式）

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

第一步：创建新项目

第二步：运行服务器看效果

第三步：创建一个新页面 —— 欢迎页

1. 创建一个视图函数（View）

2. 配置 URL 路由

第四步：再加一个显示当前时间的页面

修改 views.py：

添加 URL 映射：

第五步：使用模板返回 HTML 页面（可选但推荐）

1. 创建 templates 目录

2. 设置模板路径

3. 使用模板显示页面

常见问题与解答

❓Q1：运行 python manage.py 报错怎么办？

❓Q2：URL 访问一直 404 错误

❓Q3：改完代码看不到变化怎么办？

❓Q4：能不能换一个端口运行服务器？

学习建议：下一步我可以学什么？

📚 推荐学习路线图：

🧠 学习资源推荐：

总结一下

评论 0

为你推荐

精选内容