Django入门教程：搭建你的第一个Python网站
开篇：Django是什么？我们可以用它做什么？
Django 是一个用 Python 编写的后端开发框架，专门用来帮助我们快速搭建功能强大的网站。
你可以把 Django 想象成一个“积木工具包”：
- 它已经为你准备好了基本结构（比如数据库、用户登录、后台管理）
- 你只需专注于添加自己的内容或逻辑
- 它会自动帮你处理很多底层复杂的细节
使用 Django，你可以轻松创建如：
- 博客系统
- 网上商城
- 学生管理系统
- 新闻资讯网站
总之，Django 的目标是让开发者更高效地完成网站开发工作。
环境准备：开始前的准备工作
在正式写代码之前，我们需要先准备好开发环境。别担心，这些步骤都很简单，跟着做就行。
步骤1：安装 Python
首先，确认你电脑上是否已安装了 Python。
打开终端（Windows 叫命令提示符），输入以下命令：
python --version
如果你看到类似输出（版本号不一定一样）：
Python 3.10.6
说明你已经安装好了 Python。如果没有，请前往 官网 下载最新稳定版并安装。
✅ 注意：安装时记得勾选“Add to PATH”，这样可以直接在命令行中使用 Python。
步骤2：安装 Django
使用 pip 工具安装 Django：
pip install django
等它下载安装完成后，检查一下是否成功：
django-admin --version
如果输出了类似版本号：
4.2.7
说明 Django 已经安装好了！
核心概念：Django中的关键词解释
为了更好地理解后面的内容，我们先来认识几个 Django 中非常重要的术语：
| 概念 | 含义 |
|---|---|
| 项目（Project） | 整个网站的大容器，包含所有应用和配置 |
| 应用（App） | 网站中的某个功能模块，比如博客、用户注册等 |
| 模板（Template） | 显示网页内容的 HTML 文件 |
| 模型（Model） | 数据库表结构的定义 |
| 视图（View） | 控制网页行为和显示内容的逻辑代码 |
| URL路由（URLconf） | 指定访问哪些地址时调用哪个函数 |
这些听起来有点抽象对吧？没关系，在下面的小项目中我们会一一实践它们。
实战项目：创建第一个 Django 网站
我们将从零开始，一步一步完成一个简单的网站：欢迎页面 + 博客主页展示文章标题列表。
第一步：创建项目
在命令行中运行以下命令来创建一个新的 Django 项目：
django-admin startproject mysite
这会生成一个名为 mysite 的文件夹，里面是我们网站的基本结构。
进入该文件夹：
cd mysite
然后启动开发服务器看看效果：
python manage.py runserver
打开浏览器，访问 http://localhost:8000，你会看到一个恭喜页面，表示项目已经搭建成功！
第二步：创建应用
现在我们要创建一个叫做 blog 的子功能模块（也就是一个 App）。回到终端按 Ctrl+C 停止服务，再输入：
python manage.py startapp blog
此时你会发现多了一个叫 blog 的目录，里面有 views.py、models.py 等文件。
第三步：注册应用
为了让 Django 知道我们在使用这个应用，需要到 mysite/settings.py 文件里找到 INSTALLED_APPS 列表，加上我们的 app：
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'blog', # 添加这一行
]
第四步：编写视图函数（view）
打开 blog/views.py 文件，添加如下代码：
from django.http import HttpResponse
from django.shortcuts import render
def home(request):
posts = ["第1篇文章", "第2篇文章", "第3篇文章"]
return render(request, 'blog/home.html', {'posts': posts})
这段代码的意思是：
- 当用户请求首页的时候，返回三个假数据的文章标题
- 使用模板渲染 HTML 页面
第五步：配置 URL 路由
在 blog 目录下新建一个文件：urls.py，并写入：
from django.urls import path
from . import views
urlpatterns = [
path('', views.home, name='home'),
]
然后再去 mysite/urls.py 把 blog 的路由引入进来：
from django.urls import include, path
urlpatterns = [
path('admin/', admin.site.urls),
path('blog/', include('blog.urls')),
]
这样我们就可以通过访问 /blog/ 进入博客首页啦！
第六步：创建模板
在项目根目录下新建一个文件夹 templates/blog/，然后在里面新建一个文件 home.html：
<!DOCTYPE html>
<html>
<head>
<title>我的博客</title>
</head>
<body>
<h1>欢迎来到我的博客</h1>
<ul>
{% for post in posts %}
<li>{{ post }}</li>
{% endfor %}
</ul>
</body>
</html>
还记得我们在视图中传递的 posts 数据吗？这里就是用模板引擎把它渲染出来。
第七步：设置模板路径
为了让 Django 找到模板文件，修改 mysite/settings.py 中的 TEMPLATES 配置：
'DIRS': [BASE_DIR / 'templates'],
这样它就知道去哪里找你的 HTML 模板文件了。
现在重新运行服务器：
python manage.py runserver
访问 http://localhost:8000/blog/，你应该能看到一个包含三篇文章标题的博客首页页面啦！
常见问题解答
Q1：为什么页面没有变化，刷新还是老样子？ A：可能没有重启开发服务器。每次修改了 views 或 urls 文件后都要按 Ctrl+C 结束服务，再重新启动。
Q2：找不到 templates 文件夹怎么办？ A：请确保你手动创建了正确的文件结构，并且配置了 TEMPLATES 的路径正确指向它。
Q3：Django 报错 ModuleNotFoundError: No module named 'blog' 怎么办？
A：很可能你在 INSTALLED_APPS 中拼错了名称，或者不在项目根目录下执行 manage.py 命令。
学习建议：下一步可以学什么？
恭喜你完成了第一个 Django 网站！接下来推荐你继续学习：
- 连接真实数据库：使用 Django ORM 创建真正的文章模型
- 管理后台：用内置的 Admin 系统添加文章
- 美化前端：用 Bootstrap 给网站加样式
- 用户认证：实现登录、注册等功能
- 部署上线：将网站发布到网络上供人访问
学习资源推荐：
- Django官方文档中文版
- B站搜索 “Django入门教学” 有很多优质视频
- 推荐书籍《Django 企业开发实战》
结语
通过本篇教程，你已经掌握了 Django 的基础结构与搭建流程，并亲手创建了一个简单的博客网站。
记住一句话：编程最好的方式就是不断动手实践！
希望你能保持热情，坚持下去，成为一位优秀的后端工程师！
🚀 欢迎继续关注更多 Django 系列教程！
评论 0