Django入门教程:搭建你的第一个Python网站
开篇:Django 是什么?它能做什么?

在互联网世界中,网站开发是一门非常重要的技能。而 Django 就是 Python 中一个非常流行的“后端”框架,它可以帮助我们快速构建功能强大、安全稳定的网站。
你可以把 Django 想象成一套“搭积木”的工具包,里面已经帮你准备好了很多基本的结构和功能。你只需要按照自己的需求来搭建内容页面、用户系统、数据库等。
本教程将从零开始,带你用 Django 搭建第一个属于你自己的网站!
环境准备:安装 Python 和 Django

1. 安装 Python(版本建议为 3.8+)
请先前往官网下载安装:https://www.python.org/downloads/
💡 安装时记得勾选 “Add to PATH” 选项。
打开命令行输入:
python --version
看到类似下面的信息就表示成功了:
Python 3.9.6
2. 安装 pip(如果已自带可跳过)
pip 是 Python 的包管理器,用来安装第三方模块(例如 Django)。
在命令行输入:
python -m ensurepip --default-pip
确认 pip 是否安装成功:
pip --version
输出如下则代表安装成功:
pip 23.0.1 from ... (python 3.9)
3. 安装 Django
现在我们要用 pip 来安装 Django:
pip install django
然后检查是否安装成功:
django-admin --version
看到版本号就说明一切顺利啦!
4.2.3
核心概念:理解 Django 基础组件

Django 使用了 MTV 模型(Model, Template, View),它是传统 MVC 架构的一种变种:
- Model(模型):负责与数据库打交道,定义数据结构。
- View(视图):处理请求,决定展示什么内容。
- Template(模板):网页的 HTML 文件,决定内容如何显示。
让我们看个小例子加深印象:
# views.py 文件中写视图函数
from django.http import HttpResponse
def hello(request):
return HttpResponse("Hello, welcome to my website!")
<!-- templates/index.html 页面模板 -->
<!DOCTYPE html>
<html>
<head><title>Welcome</title></head>
<body>
<h1>{{ message }}</h1>
</body>
</html>
这三大块构成了 Django 的核心运作方式。
实战项目:搭建一个简单的博客首页
我们将一步步完成一个小项目——创建一个可以显示欢迎语的博客首页!
第一步:新建 Django 项目
在命令行运行:
django-admin startproject myblog
cd myblog
你会看到如下目录结构:
myblog/
├── manage.py
└── myblog/
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
第二步:启动服务器测试
运行以下命令开启本地开发服务器:
python manage.py runserver
在浏览器地址栏输入 http://127.0.0.1:8000/,看到 Django 默认欢迎页,就表示服务器成功了 ✅。
第三步:创建我们的应用 app
Django 项目是由多个“应用(App)”组成的。比如用户登录是一个 App,博客文章也是一个 App。
执行命令生成一个新的 blog 应用:
python manage.py startapp blog
现在你需要注册这个应用到主项目里,在 myblog/settings.py 的 INSTALLED_APPS 列表最后加上 'blog':
INSTALLED_APPS = [
...
'blog',
]
第四步:创建视图与路由
打开 blog/views.py 添加如下代码:
from django.http import HttpResponse
def index(request):
return HttpResponse("欢迎访问我的博客主页!")
接下来配置 URL 路由。修改 myblog/urls.py:
from django.urls import path
from blog import views
urlpatterns = [
path('', views.index),
]
现在重启服务器并再次访问 http://127.0.0.1:8000/,你将会看到我们自己写的欢迎信息 🎉
第五步:使用模板展示网页
为了展示更丰富的网页,我们加入模板功能。
新建模板文件夹
在项目根目录下创建一个 templates 文件夹,并新增文件 index.html:
<!-- templates/index.html -->
<h1>Hello, My Blog!</h1>
<p>这是我的第一个 Django 网站~</p>
修改 views.py:
from django.shortcuts import render
def index(request):
return render(request, 'index.html')
刷新页面,你应该能看到 HTML 页面渲染出来的结果!
常见问题解答
Q1: 运行命令提示 ‘django-admin’ 不是内部或外部命令?
A: 可能是你没有把 Python 或 pip 加入环境变量 PATH,建议重新安装并确保勾选“Add to PATH”。
Q2: 修改完页面没变化怎么办?
A: 有时候服务器会缓存,尝试按下 Ctrl+C 停止服务后再重启一次。
Q3: 出现 TemplateDoesNotExist 错误?
A: 可能是模板路径设置有问题,需要在 settings.py 中配置 TEMPLATES_DIRS,参考文档:Django Templates 配置指南。
学习建议:下一步该学什么?
恭喜你完成了第一个 Django 网站!接下来你可以尝试深入这些方向:
✅ 数据库操作
学习如何用 Django 的 ORM(对象关系映射)来连接数据库并保存文章。
✅ 表单提交与验证
添加评论功能时,会用到用户输入提交的数据校验。
✅ 用户登录与权限管理
学会做用户的注册、登录、登出系统。
✅ 部署上线
了解如何将项目部署到线上服务器(如 Nginx + Gunicorn 部署)。
🎉 总结一下:
- 我们学会了 Django 环境的搭建;
- 了解了它的核心概念 Model、View、Template;
- 动手实现了第一个网页;
- 解决了一些常见问题;
- 并规划了后续学习的方向。
继续加油,下一个酷炫网站说不定就是你做的!😊

评论 0