Django入门教程：搭建你的第一个Python网站
开篇：Django 是什么？用来做什么？
你可能听说过 Python，它是一种非常受欢迎的编程语言，以简洁和强大的特点受到广泛欢迎。而 Django 就是建立在 Python 基础上的一个用于开发 Web 网站的工具（我们称之为“框架”）。
简单来说，Django 帮助你快速搭建功能齐全的网站。它可以处理网页访问、用户登录、数据库操作、后台管理等功能，几乎涵盖了所有网站需要的基本功能。
如果你的梦想是做一个自己的博客、商城、学习平台或者社交网站，那么 Django 将是一个非常好的起点。
环境准备：安装好我们的“工作台”
为了使用 Django，我们需要先准备好开发环境。请不要担心，这部分操作并不会太复杂。
步骤一：安装 Python
确保你的电脑上已经安装了 Python（推荐版本 3.8 或以上）。你可以通过运行下面的命令来检查是否安装成功：
python --version
如果出现类似 Python 3.10.4 的信息，说明安装成功了。如果没有，请到 Python官网 下载并安装。
步骤二：安装 pip（Python 包管理器）
大多数情况下，安装 Python 时会自动安装 pip。可以用下面命令检查：
pip --version
如果没有安装，可以在安装 Python 时勾选“Add to PATH”或重新安装后尝试。
步骤三：安装 Django
现在我们来安装 Django 框架：
pip install django
等待几秒钟安装完成后，可以输入以下命令验证是否安装成功：
django-admin --version
如果输出了 Django 的版本号，表示安装完成了！
核心概念：理解几个关键名词
在开始写代码之前，我们先来了解一些基本的概念，它们就像盖房子的地基一样重要。
项目（Project）
Django 项目代表整个网站的总体结构，它是多个应用的集合。比如，一个购物网站可能包含商品展示模块、订单模块、用户模块等，每个模块都可以作为独立的应用放在这个项目中。
应用（App）
一个应用是完成某个具体功能的小单元。比如，“用户登录”功能可以作为一个应用，“新闻发布”也可以作为一个应用。这些应用共同构成了完整的网站。
模型（Model）
模型就是网站背后的数据存储规则。我们可以把它想象成一张表格，每张表里有很多列（字段），记录着不同的数据。例如，一个“博客文章”的模型可能会包括标题、内容、发布日期等信息。
视图（View）
视图决定了当用户访问某个网址时，系统如何响应。比如说，用户访问 /about/ 页面时，应该显示哪些内容，这就是由视图决定的。
模板（Template）
模板是网页的“骨架”，它决定了页面的外观。我们可以把数据显示在模板中的特定位置，从而动态地生成网页内容。
URL 路由（URLconf）
URL 路由就像是导航地图，告诉 Django 用户访问 /、/about/ 这样的地址时，该去调用哪个视图函数进行处理。
实战项目：从零开始创建一个简单的网站
下面我们来一步步搭建一个简单的个人网站主页。目标是：打开网站首页时，能看到一段欢迎语句。
第一步：创建项目
我们先来创建一个新的 Django 项目：
django-admin startproject mysite
执行完成后，会在当前目录下生成一个名为 mysite 的文件夹，里面包含了项目的结构。
进入项目文件夹：
cd mysite
这时你会发现如下文件结构：
mysite/
├── manage.py # 管理脚本
└── mysite/
├── __init__.py
├── settings.py # 配置文件
├── urls.py # 路由配置
└── wsgi.py
第二步：启动服务器测试一下
在终端运行下面这条命令启动本地服务器：
python manage.py runserver
然后打开浏览器，输入地址：
http://127.0.0.1:8000/
你应该看到一个写着 “It worked!” 的页面，这说明你的 Django 环境已经正常运行啦！
按下 Ctrl + C 停止服务器。
第三步：创建第一个应用
现在我们要创建一个具体的“应用”来实现首页的功能：
python manage.py startapp homepage
这时你会看到新增了一个叫做 homepage 的文件夹。
接下来我们需要把这个新应用注册到项目中，在 mysite/settings.py 中找到 INSTALLED_APPS 列表，添加一行：
INSTALLED_APPS = [
...
'homepage',
]
这样 Django 就能识别这个应用啦！
第四步：编写视图函数
打开 homepage/views.py 文件，输入下面这段代码：
from django.http import HttpResponse
def index(request):
return HttpResponse("欢迎来到我的个人网站！")
这段代码定义了一个叫做 index 的视图函数，它的作用是当有人访问这个页面时，返回一句欢迎的话。
第五步：配置路由
为了让 Django 知道哪里可以访问这个视图，我们需要配置 URL 路由。
打开 mysite/urls.py 文件，修改为如下内容：
from django.urls import path
from homepage import views
urlpatterns = [
path('', views.index, name='index'),
]
这里的意思是：当用户访问主路径（也就是“空字符串”）的时候，调用 views.index 函数返回结果。
第六步：再次运行服务器查看效果
再次运行服务：
python manage.py runserver
打开浏览器访问：http://127.0.0.1:8000/
现在你会看到页面上出现了“欢迎来到我的个人网站！”这句话，恭喜你，你的第一个 Django 网站就完成了！
常见问题：新手最常遇到的问题及解决办法
1. 提示“找不到模块”怎么办？
可能是没有正确激活虚拟环境或未安装所需包。建议：
- 使用
pip install django检查是否安装了 Django； - 检查是否拼错了 app 名字（如忘记大小写或少字母）。
2. 修改代码后页面没变化？
Django 自带的开发服务器不会自动重启，你需要手动停止再运行一次：
Ctrl + C → 再次运行 python manage.py runserver
3. 报错：You're using the staticfiles app without having set the STATIC_ROOT setting.
这个问题通常出现在部署网站时才需要解决，目前可以忽略。完整网站开发过程中我们会详细讲解静态资源的配置方式。
4. 启动服务器报错 Port 8000 already in use？
说明端口被占用了。可以更换端口，例如：
python manage.py runserver 8001
学习建议：下一步怎么学下去？
恭喜你完成了第一个 Django 网站！这只是万里长征的第一步。接下来你可以：
✅ 继续学习以下知识：
- 模板系统：学会使用 HTML 页面，让网站更有“颜值”。
- 数据库建模：创建真实的用户、文章等内容。
- 表单与用户输入：让用户能够提交信息（比如留言）。
- 用户认证系统：添加登录、注册功能。
- 静态文件管理：引入 CSS、图片等美化网站。
📚 推荐学习资源：
- 官方文档：https://docs.djangoproject.com/
- 推荐书籍：《Django for Beginners》《流畅的Python》
- B站搜索“Django入门”也有很多中文视频课程可供参考。
💡 实践建议：
动手才是最好的老师。建议你在掌握了基本语法之后尝试开发一个小项目，比如：
- 个人博客网站
- 留言板
- 简单的商品管理系统
- 微型论坛
小结
本文从基础出发，带你一步步安装 Django、创建网站，并完成了一个简单的首页功能。虽然只是一个简单的“Hello World”，但这已经为你打开了通往 Web 开发的大门。
记住一句话：“写代码不怕犯错，怕的是不去试。”
希望你能在这条路上越走越远，最终做出属于自己的网站作品！
如果你觉得这篇文章有帮助，不妨分享给想学编程的朋友吧 😊
评论 0