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

代码小镇

2025-06-12 13:38

阅读 545

如果你是零基础的新手，想用 Python 快速开发一个自己的网站，那么 Django 就是你的最佳选择。它是一个强大的 Web 开发框架，帮助开发者快速构建功能齐全的网站。本文将从最基础开始，手把手教你如何创建第一个 Django 网站。

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

1. Django 是什么？

Django 是使用 Python 编写的 Web 开发框架（Framework）。简单来说，它是一组预先写好的代码和工具，可以帮助你快速地搭建网站。

就像盖房子一样，Django 提供了砖瓦水泥、门窗地板这些“现成材料”，你只需要按照需求来设计和组装即可，而不用从头造起所有部件。

2. Django 能做什么？

构建博客网站
创建电商系统
搭建企业官网或管理后台
开发API接口供其他应用调用
大型内容管理系统（CMS）

总之，只要涉及网页内容的动态展示、数据库操作、用户登录等功能，Django 都能胜任。

二、环境准备：安装必要的工具

在正式开始之前，我们需要为我们的电脑准备好一些工具：

1. 安装 Python

Django 是基于 Python 的，所以首先要确保你已经安装好 Python。

👉 步骤：

打开浏览器，访问 https://www.python.org/downloads/
下载适合你系统的版本（推荐使用最新稳定版）
安装过程中一定要勾选 Add Python to PATH
安装完成后，在命令行中输入 python --version 或 python3 --version，查看是否显示版本号（如 3.10, 3.11 等）

✅ Windows 用户注意：如果提示 python 不是内部命令，请检查是否添加了环境变量，或者尝试使用 py 命令替代。

2. 安装虚拟环境 Virtualenv

为了避免不同项目之间依赖冲突，我们通常会使用 虚拟环境（Virtual Environment） 来隔离每个项目的依赖。

# 安装 virtualenv 工具
pip install virtualenv

然后创建并激活虚拟环境：

# 创建名为 myenv 的虚拟环境
virtualenv myenv

# 激活虚拟环境（Windows）
myenv\Scripts\activate

# 激活虚拟环境（Mac/Linux）
source myenv/bin/activate

激活成功后，你会看到命令行前有 (myenv) 字样。

3. 安装 Django

现在我们可以安装 Django 了。

pip install django

安装完成后输入：

django-admin --version

输出类似 4.2.7 表示安装成功！

三、核心概念：理解Django的几个重要概念

即使你是初学者，也要了解一些基本术语和结构。下面是新手最常听到的几个词：

1. 项目 Project 和应用 App

Project（项目）：整个网站的总容器，包含配置文件和多个 App。
App（应用）：实现特定功能的小模块。例如，一个博客网站可以有 blog App、users App。

你可以把项目想象成整栋大楼，App 就是里面的房间。

2. MVT 模式（Model - View - Template）

这是 Django 使用的开发模式，帮助你组织代码结构：

层级	作用
Model	负责与数据库交互（比如保存文章）
View	控制逻辑，决定显示什么内容
Template	HTML 文件，负责展示页面

3. URL路由（URL Routing）

URL 就是你在浏览器里输入的网址。Django 根据不同的 URL 地址，把请求分配给对应的处理函数。

举个例子：

http://example.com/about/
http://example.com/blog/2024-10-01/hello-world

这些地址最终都会交给 view 函数处理。

四、实战项目：创建第一个Django网站

我们接下来要做的，是一个非常简单的个人博客主页。

第一步：创建项目

使用 Django 命令创建一个项目：

django-admin startproject mysite

这将在当前目录下创建一个名为 mysite 的项目文件夹。

进入项目文件夹：

cd mysite

运行测试服务器：

python manage.py runserver

打开浏览器，访问 http://127.0.0.1:8000/，你会看到 Django 的默认欢迎页面。

第二步：创建 App

我们要做一个展示首页的 App，叫 pages：

python manage.py startapp pages

这个命令会在项目里新增一个叫做 pages 的文件夹，里面包含了默认的 App 结构。

别忘了在 settings.py 中注册这个 App：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    # 我们自己加的 app
    'pages',
]

第三步：编写视图（View）

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

from django.http import HttpResponse

def home(request):
    return HttpResponse("欢迎来到我的博客！")

第四步：配置 URL 路由

我们要让访问根路径 / 时触发上面的 home 函数。

在 pages/urls.py 文件中添加：

from django.urls import path
from . import views

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

如果没有这个文件，新建一个就行。

然后在项目主路由中引入该 App 的 URLs：

修改 mysite/urls.py：

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

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

现在再运行服务：

python manage.py runserver

打开 http://127.0.0.1:8000/，你应该能看到 “欢迎来到我的博客！” 这句话了！

第五步：使用模板（Template）美化页面

刚才我们返回的是纯文本，现在我们来渲染 HTML 页面。

在 pages 文件夹下创建模板文件夹：

pages/templates/pages/index.html

并在 index.html 中写下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>我的博客</title>
</head>
<body>
    <h1>欢迎来到我的博客！</h1>
    <p>这是我的第一个 Django 页面。</p>
</body>
</html>

修改 views.py 使用模板：

from django.shortcuts import render

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

刷新网页，现在你就能看到漂亮的 HTML 页面啦！

五、常见问题解答（FAQ）

服务器部署方案-1

Q1：启动服务器时报错：“No module named django”

A：可能没有正确安装 Django，或未激活虚拟环境。可以用以下命令检查：

which python   # 查看使用的 Python 路径
pip show django  # 看 Django 是否已安装

如果没有，请重新安装。

Q2：URL 显示空白页面

A：确认：

视图函数是否被调用？
路由配置是否正确？
是否重启了服务？

建议先打印一下调试信息：

def home(request):
    print("Hello from view")  # 控制台打印
    return render(...)

Q3：出现 TemplateDoesNotExist 错误

A：可能是模板路径设置不对。Django 默认在 templates/ 目录下查找模板。

检查目录结构是否正确：

pages/
├── templates/
│   └── pages/
│       └── index.html

模板路径要符合 应用名/文件名.html 的格式。

六、学习建议：下一步怎么做？

恭喜你完成了第一个 Django 网站！接下来你可以继续学习以下几个方向：

学习路线建议：

学习阶段	推荐知识点
初级	数据库模型 Model、Admin 后台、静态文件配置
中级	用户登录、表单提交、分页显示、前后端分离
高级	RESTful API、性能优化、部署上线（Nginx + Gunicorn）

总结

本篇文章带你一步一步从零开始搭建了一个基于 Django 的简单网站。从环境安装到视图、模板、URL 配置，每一步都配有实际代码示例，并解答了新手常见问题。

记住一句话：“最好的学习方式就是做项目”。不要害怕出错，多动手实践，你会越来越熟练！

如果你喜欢这种风格，欢迎关注我更多关于 Django 与 Python 的进阶系列教程 😊

📌 小练习任务：

把首页改成一个介绍页面，内容自定
给首页增加 CSS 样式，让它更好看
再加一个页面，展示 "About Me" 介绍，用新的 URL 访问

祝你快乐学习 Django，早日成为全栈工程师！

标签:面试题代码人生

最热最新

暂无评论

为你推荐

暂无相关推荐

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

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

1. Django 是什么？

2. Django 能做什么？

二、环境准备：安装必要的工具

1. 安装 Python

2. 安装虚拟环境 Virtualenv

3. 安装 Django

三、核心概念：理解Django的几个重要概念

1. 项目 Project 和应用 App

2. MVT 模式（Model - View - Template）

3. URL路由（URL Routing）

四、实战项目：创建第一个Django网站

第一步：创建项目

第二步：创建 App

第三步：编写视图（View）

第四步：配置 URL 路由

第五步：使用模板（Template）美化页面

五、常见问题解答（FAQ）

Q1：启动服务器时报错：“No module named django”

Q2：URL 显示空白页面

Q3：出现 TemplateDoesNotExist 错误

六、学习建议：下一步怎么做？

学习路线建议：

推荐学习资源

总结

评论 0

为你推荐

精选内容

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

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

1. Django 是什么？

2. Django 能做什么？

二、环境准备：安装必要的工具

1. 安装 Python

2. 安装虚拟环境 Virtualenv

3. 安装 Django

三、核心概念：理解Django的几个重要概念

1. 项目 Project 和 应用 App

2. MVT 模式（Model - View - Template）

3. URL路由（URL Routing）

四、实战项目：创建第一个Django网站

第一步：创建项目

第二步：创建 App

第三步：编写视图（View）

第四步：配置 URL 路由

第五步：使用模板（Template）美化页面

五、常见问题解答（FAQ）

Q1：启动服务器时报错：“No module named django”

Q2：URL 显示空白页面

Q3：出现 TemplateDoesNotExist 错误

六、学习建议：下一步怎么做？

学习路线建议：

推荐学习资源

总结

评论 0

为你推荐

相关推荐

精选内容

1. 项目 Project 和应用 App