Django入门教程：搭建你的第一个Python网站
开篇：Django是什么，用来做什么？
你有没有想过，自己也能创建一个网站？不是用那种可视化拖拽工具，而是真正“写代码”来实现的网站。如果你会一点Python基础（比如变量、函数这些），那恭喜你，已经具备了学习 Django 的条件。
Django 是一个基于 Python 的 Web 开发框架，它能帮助你快速地开发功能齐全、结构清晰的网站。很多知名的网站，比如 Instagram 和 Disqus，都是用 Django 构建的。
为什么选择 Django 来做网站呢？因为它：
- 自带了很多实用功能（比如用户登录、数据库管理等）
- 语法简洁，容易上手
- 社区活跃，文档丰富
- 适合从零开始学起的小白用户
接下来我们就开始一步步地搭建我们的第一个 Django 网站吧！
环境准备：搭建你的开发环境
在正式写代码之前，我们需要准备好一些软件和工具。别担心，只要跟着步骤操作，几分钟就能搞定。
第一步：安装 Python
Django 是基于 Python 的，所以首先要安装 Python。你可以访问 Python 官网 下载安装包。
Windows 用户注意： 安装时记得勾选 “Add Python to PATH”，这样安装完后系统就能识别 Python 命令。
安装完成后，在命令行中输入以下命令检查是否安装成功：
python --version
如果输出类似 Python 3.10.x，说明安装成功。
第二步：安装 pip（Python 包管理器）
pip 是用来安装 Python 第三方库的工具。大多数现代 Python 版本都自带了 pip，我们可以运行下面命令查看它是否存在：
pip --version
如果有版本号输出，就说明没问题。如果没有，请重新安装 Python 并确保勾选了安装 pip 的选项。
第三步：安装 Django
接下来我们使用 pip 安装 Django。运行以下命令：
pip install django
安装完成后，可以输入命令确认版本：
django-admin --version
你会看到类似 4.2.5 这样的数字，说明安装成功。
第四步：设置你的项目文件夹
建议你在电脑上新建一个文件夹，例如叫 my_django_project，作为我们项目的根目录。打开终端（或 CMD）并进入这个目录，后面我们会在这个目录下建立项目。
核心概念讲解：什么是“MVT”？它们是怎么工作的？
在正式写代码之前，我们先来简单了解几个重要的术语，这有助于理解整个项目的结构。
1. 什么是 MVT 模式？
Django 使用一种叫做 MVT 的架构模式：
- Model（模型）：对应数据库中的表结构，负责数据的存储和操作。
- View（视图）：处理请求逻辑，决定显示哪些数据。
- Template（模板）：网页的 HTML 页面，用来展示数据。
听起来是不是有点像 MVC？其实这是 Web 框架常用的结构，只是名字不太一样而已。
2. 什么是项目与应用？
- 项目（Project）：就是整个网站的总工程，包含多个应用。
- 应用（App）：是具体的功能模块，例如“博客”、“新闻”等。
举个例子：你要做一个电商网站，可以有“商品浏览”、“购物车”、“订单管理”等多个应用组成整个项目。
3. URL 分发器（urls.py）
这个文件决定了用户访问哪个页面，应该跳转到哪个处理函数。它是项目的“导航地图”。
4. 数据库迁移（Migration）
当你改变了数据库结构（比如加了一个字段），你需要通过迁移来更新数据库。Django 提供了强大的自动迁移工具。
实战项目：从无到有，创建一个简单的“Hello World”网站
好了，理论讲得差不多了，现在让我们动手写第一个网站吧！我们会构建一个最简单的网页：当用户访问 /hello/ 地址时，显示 “Hello, World!”。
第一步：创建 Django 项目
在你新建的文件夹中执行下面的命令：
django-admin startproject mysite .
这里解释一下：
mysite是项目名称- 最后的
.表示把项目文件生成在当前目录中（而不是嵌套子目录）
完成后你会看到如下的文件结构：
mysite/
├── manage.py
└── mysite/
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
第二步：运行服务器看看效果
输入命令启动开发服务器：
python manage.py runserver
默认访问地址是 http://127.0.0.1:8000，打开浏览器访问这个网址，你会看到一个欢迎页面，说明服务正常启动。
第三步：创建一个新应用
我们要做的“Hello World”属于一个单独的应用。执行命令：
python manage.py startapp hello
此时会新增一个 hello 文件夹，里面有一些初始化文件，包括 views.py、urls.py 等。
第四步：编写视图函数
打开 hello/views.py，添加如下代码：
from django.http import HttpResponse
def say_hello(request):
return HttpResponse("Hello, World!")
这段代码的意思是：
- 当有人访问网页时（即发送 HTTP 请求），会调用这个函数
- 函数返回一段文字：“Hello, World!”
第五步：配置 URL 路由
为了让程序知道哪个地址对应哪个函数，我们需要修改两个 urls.py 文件。
首先是项目主路由文件：mysite/urls.py，修改如下：
from django.urls import path, include
urlpatterns = [
path('hello/', include('hello.urls')),
]
然后我们在 hello/ 目录下新建一个 urls.py 文件，内容如下：
from django.urls import path
from . import views
urlpatterns = [
path('', views.say_hello),
]
这样配置后：
- 访问 http://127.0.0.1:8000/hello/ 时
- 就会触发
say_hello函数，并显示 “Hello, World!”
第六步：再次运行服务器测试
运行命令：
python manage.py runserver
在浏览器中打开 http://127.0.0.1:8000/hello/，你应该会看到熟悉的 “Hello, World!” 字样！
恭喜！你的第一个 Django 网站就这样诞生了！
常见问题解答
Q1：出现错误提示 “command not found: django-admin”
A：请确认是否已正确安装 Django，可以通过以下命令重装：
pip install --upgrade django
另外，部分系统可能要用 python -m django 替代 django-admin，例如：
python -m django startproject mysite
Q2：无法访问 localhost:8000 页面
A：请检查是否正在运行服务器，或者是否有其他程序占用了端口 8000。可以用下面命令指定不同端口：
python manage.py runserver 8080
Q3：找不到某个模块，如 “No module named 'hello'”
A：请确认是否将新创建的 app 添加进了项目设置中。打开 mysite/settings.py，找到 INSTALLED_APPS，添加 'hello', 到列表中：
INSTALLED_APPS = [
...
'hello',
]
学习建议：下一步该学什么？
你现在掌握了最基本的 Django 知识。接下来推荐你继续学习以下内容，逐步提升自己的技能：
1. 模板系统 Template
学会使用 HTML + Django 模板语法渲染网页内容，让网站更美观、动态化。
示例知识点：
{% if %}条件判断{% for %}循环语句- 模板继承
2. 数据库与模型（Models）
学习如何定义模型类，连接数据库（通常是 SQLite），进行增删改查等基本操作。
推荐练习：
- 创建一个“书籍”数据库模型
- 编写 API 接口获取所有书名
- 页面上展示所有图书信息
3. 表单处理 Form
掌握用户提交数据的方式，如注册、登录、搜索等功能背后的原理。
常用模块：
forms.Formforms.ModelForm
4. 静态文件处理（CSS/JS 图片）
学会加载静态资源，让你的网页更漂亮。
5. 登录认证系统
Django 自带强大的用户认证系统，你可以轻松实现登录、登出、权限控制等。
推荐学习资源
- Django官方文档
- Real Python 教程
- YouTube 上搜关键词 "Django tutorial"
- 中文社区资源：掘金、知乎专栏
总结
本教程从零开始，带你完成了 Django 环境搭建、核心概念解释、第一个网站搭建，并解答了一些常见问题。希望你能对 Web 开发产生兴趣，并继续深入学习下去。
记住：编程是一个不断实践的过程，多敲代码、多尝试、多犯错，你就离高手不远啦！
🎉 祝你早日成为一名优秀的 Django 开发者！如果你觉得这篇教程对你有帮助，欢迎分享给更多刚入门的朋友哦～
评论 0