Django入门教程：搭建你的第一个Python网站
开篇：Django是什么？用来做什么？
在互联网的世界里，网站背后往往运行着复杂的程序代码。这些程序负责接收用户的请求、处理数据，并返回网页内容。Django 就是一个专门帮助我们快速开发这类网站后端程序的工具，它是使用 Python语言 编写的，特别适合初学者上手。
简单来说，Django就像一个“网页开发的乐高积木”——它已经帮我们搭好了很多基础框架（比如用户登录系统、数据库连接等），你只需要专注于实现自己的功能即可。
如果你是第一次学习如何做网站，Django是一个非常好的起点。它的理念是“让开发者少写重复代码”，非常适合搭建各种类型的网站项目，从个人博客、电商网站到企业管理系统，都能用Django来完成。
环境准备：搭建你的开发环境
在开始写代码之前，我们需要安装一些必需的软件工具。不要担心，这一步不会太复杂。
1. 安装 Python
Django 是基于 Python 的，所以我们首先需要在电脑上安装 Python。
- 前往官网下载最新版的 Python：https://www.python.org/downloads/
- 在安装时请勾选 Add to PATH（Windows）
- 安装完成后打开终端或命令行输入：
python --version
如果看到类似 Python 3.x.x 的信息，说明安装成功！
2. 创建虚拟环境（推荐）
为了不让不同项目的依赖混乱，我们通常会为每个项目创建一个独立的“空间”，这个空间叫做虚拟环境。
# 创建一个名为 myenv 的虚拟环境
python -m venv myenv
激活虚拟环境：
Windows 上执行：
myenv\Scripts\activateMac/Linux 上执行：
source myenv/bin/activate
激活之后，命令行前会显示 (myenv) 表示你现在在这个环境中工作。
3. 安装 Django
激活虚拟环境后，在命令行中执行以下命令：
pip install django
安装完成后验证是否成功：
django-admin --version
如果输出版本号（如 4.2.5），就表示安装成功了！
核心概念：Django中的关键名词解释
Django 包含了很多专业术语，但别担心，我用最简单的语言帮你理解它们。
| 名词 | 解释 |
|---|---|
| 项目（Project） | 整个网站的总容器，就像一座房子，包含所有的房间（应用）。 |
| 应用（App） | 功能模块，比如博客功能是一个应用，用户注册是另一个应用。 |
| 模型（Model） | 数据结构定义，告诉 Django 我们要保存什么数据，比如“文章”或“用户”。 |
| 视图（View） | 负责处理用户请求（比如点击链接），并决定展示什么内容。 |
| 模板（Template） | 网页的HTML文件，用于显示动态内容。 |
| URL路由（URL Router） | 把用户访问的不同网址分配给对应的视图函数处理。 |
你可以把整个项目想象成一本书：
- 项目就是这本书；
- 应用就是书里的章节；
- 模型就是章节中的内容；
- 视图是章节的正文部分；
- 模板是正文的格式和排版；
- URL路由就是目录，告诉读者该去哪里找哪个章节。
实战项目：跟着教程一步步做一个网站
我们来做一个小项目：一个名叫 Hello World 的简易网站，当用户访问首页时，显示一句“欢迎来到我的第一个Django网站”。
第一步：创建项目
django-admin startproject helloworld
然后进入项目文件夹：
cd helloworld
此时你会看到这样的文件结构：
helloworld/
manage.py
helloworld/
__init__.py
settings.py
urls.py
asgi.py
wsgi.py
manage.py：管理项目的命令行工具。settings.py：项目的配置文件。urls.py：存放所有网页地址的配置。
第二步：启动服务器看看效果
在命令行中执行：
python manage.py runserver
然后打开浏览器，访问 http://127.0.0.1:8000，你应该能看到 Django 默认的欢迎页面。
第三步：创建应用
现在我们要添加一个应用来展示我们的“欢迎语”。
python manage.py startapp homepage
这样就会多出一个叫 homepage 的文件夹，里面有一些初始文件。
你需要把这个应用加入到项目中。找到 helloworld/settings.py 文件，在 INSTALLED_APPS 列表中添加：
'homepage',
第四步：编写视图函数
打开 homepage/views.py，写入下面的代码：
from django.http import HttpResponse
def home(request):
return HttpResponse("欢迎来到我的第一个Django网站！")
这里我们定义了一个叫做 home 的函数，它接收一个请求参数 request，返回一个文本响应。
第五步：设置 URL 路由
在 helloworld/urls.py 中修改内容如下：
from django.contrib import admin
from django.urls import path
from homepage import views
urlpatterns = [
path('admin/', admin.site.urls),
path('', views.home), # 添加这一行
]
这样，当我们访问根路径 / 时，就会调用我们在 views.py 中写的 home() 函数。
刷新浏览器，现在你应该看到：
欢迎来到我的第一个Django网站！
🎉恭喜你，完成了你的第一个 Django 网站！
常见问题：新手容易遇到的问题及解决方案
❓1. 运行 runserver 时报错 “CommandError: Can't find the file 'wsgi.py’”
👉 你可能不在正确的文件夹内。请确保你在 manage.py 所在的目录下运行命令。
❓2. 浏览器访问页面空白或报错
👉 可能是忘记启动服务 (runserver) 或者没有正确配置 URL 路由，请检查 urls.py 和 views.py 是否有拼写错误。
❓3. 安装 Django 时提示权限问题
👉 你可以尝试加上管理员权限安装：
- Windows 上以管理员身份打开命令行；
- Mac/Linux 使用
sudo pip install django。
❓4. 虚拟环境激活失败
👉 Windows 用户路径应为 myenv\Scripts\activate，注意是反斜杠 \；Linux/macOS 用的是正斜杠 /。
❓5. 修改了代码但看不到变化？
👉 Django 开发服务器会自动重启，但如果没生效，可以手动按 Ctrl + C 停止服务器后再重新启动。
学习建议：下一步怎么学？
完成本教程只是一个开始，接下来你可以尝试：
✅ 继续深入学习的方向：
- 模板系统（Templates）：学会用 HTML 显示漂亮的网页；
- 数据库建模（Models）：存储和读取用户数据；
- 静态文件管理（CSS/JS/images）：让你的网站更好看；
- 使用管理后台（Admin）：轻松管理内容；
- 用户注册与登录（Authentication）：增加用户互动功能。
📚 推荐学习资源：
- Django官方文档
- B站或YouTube上的 《Django 入门实战》视频教程
- GitHub 上搜索 "beginner django project" 查看开源项目参考
结尾总结
通过本篇文章，你已经学会了如何：
- 安装 Django 并搭建基本开发环境
- 创建一个 Django 项目并运行本地服务器
- 理解核心概念如应用、视图、URL 路由
- 编写你的第一个网页响应
- 处理常见的新手错误
记住一句话：“编程最重要的是动手实践。”
继续敲代码，不断尝试新功能，你就能慢慢掌握 Django，最终做出属于自己的完整网站！
如果你喜欢这种讲解方式，欢迎留言告诉我你想了解的下一个主题。祝你学习愉快，一路进步！🚀
评论 0