Django入门教程：搭建你的第一个Python网站
开篇：Django 是什么？能做什么？
如果你是编程零基础的新手，第一次接触 Django 这个词可能会感到有点陌生。没关系，我们来用一句话简单说明：
Django 是一个使用 Python 编写的“网站开发工具包”，它可以帮助你快速地搭建功能强大的网站。
你可以用它做各种网页应用，比如博客、商城、论坛、管理系统等等。很多大型网站（如Instagram）都是用 Django 构建的！
在本篇文章中，我们将一起一步步搭建出你的第一个 Django 网站。别担心，即使你从没写过代码也没关系，我们会从最基础的地方讲起。
环境准备：搭建你的 Django 开发环境
要开始使用 Django，我们需要先安装一些必要的软件和工具。别担心，这些步骤都很简单。
1. 安装 Python
Django 是基于 Python 的，所以我们首先要安装 Python。建议下载最新稳定版本（目前推荐 Python 3.10 - 3.12）：
安装时记得勾选 “Add to PATH”（Windows 用户），这样可以更方便地使用命令行工具。
安装完成后，在终端或命令行输入以下命令确认是否安装成功：
python --version
你会看到类似这样的输出：
Python 3.12.2
如果是 command not found 或其他错误，请重新检查安装过程。
2. 创建虚拟环境
为了避免和其他项目的库冲突，我们一般会为每个项目创建一个独立的“虚拟环境”。
在你的项目目录下运行：
python -m venv myenv
然后激活虚拟环境：
- Windows:
myenv\Scripts\activate
- macOS/Linux:
source myenv/bin/activate
你会看到命令行前缀变成 (myenv)，表示进入了虚拟环境。
3. 安装 Django
接下来我们用 pip 安装 Django：
pip install django
安装完成后检查一下版本：
django-admin --version
输出示例：
4.2.6
恭喜你！现在你的开发环境已经准备好啦 ✅
核心概念：Django 中最重要的几个术语
虽然你现在可能还不太理解，但下面这几个概念非常重要。我们用生活中的比喻来帮助你记忆：
| 概念 | 类比 | 解释 |
|---|---|---|
| 项目（Project） | 一本书 | 一个完整的网站结构，包含多个“章节”（应用） |
| 应用（App） | 一本中的章节 | 具体的功能模块，例如“文章管理”、“用户登录”等 |
| 模板（Template） | 设计稿 | 控制网页外观的部分，用来展示数据 |
| 模型（Model） | 数据库表格 | 描述我们要保存的数据的结构 |
| 视图（View） | 售货员 | 处理请求，调取数据并返回给模板 |
| URL 配置（URLconf） | 目录 | 控制不同网页地址对应哪个功能 |
是不是感觉清楚了一些？我们可以边写代码边加深理解。
实战项目：跟着我们一起建一个简单的网站
我们现在来做个小项目：搭建一个能显示“Hello, World!”的网页 😊
第一步：创建项目
在你喜欢的文件夹中运行：
django-admin startproject helloworld
这会创建一个名为 helloworld 的新项目。进入这个目录：
cd helloworld
此时你会看到如下文件结构：
helloworld/
├── manage.py
└── helloworld/
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
这些文件暂时不用管，记住一点：manage.py 是我们操作项目的“超级开关”。
第二步：运行开发服务器
输入命令启动服务器：
python manage.py runserver
打开浏览器访问 http://127.0.0.1:8000，你应该能看到欢迎页面，说明 Django 启动成功！
第三步：新建一个应用
我们的项目就像一本书，现在我们需要添加一个“章节”：
python manage.py startapp hello
你会看到多了一个叫 hello 的文件夹，里面有一系列默认生成的文件。
为了让项目识别这个新应用，需要在 helloworld/settings.py 文件中，找到 INSTALLED_APPS 列表，加入：
'hello',
第四步：创建一个页面
现在我们要让这个页面显示 “Hello, World!”
1. 修改视图函数
编辑 hello/views.py 文件，添加如下内容：
from django.http import HttpResponse
def index(request):
return HttpResponse("Hello, World!")
这是我们的第一个视图函数，作用就是接收网页请求，然后返回一句话。
2. 配置 URL 路由
首先，修改 hello 应用下的 urls.py 文件（没有就手动创建一个），内容如下：
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
]
接着，在项目主配置文件 helloworld/urls.py 中引入该应用的路由：
from django.urls import include, path
urlpatterns = [
path('hello/', include('hello.urls')),
]
现在访问 http://127.0.0.1:8000/hello/ 就会显示“Hello, World!”了！
小结一下做了哪些事：
- 创建项目 ➡️
startproject - 创建应用 ➡️
startapp - 写一个视图函数 ➡️ 返回网页内容
- 设置 URL 映射 ➡️ 把网址和视图绑定起来
是不是很有成就感 😄
常见问题解答
问题 1：为什么运行 runserver 出现“no such command”错误？
👉 答：可能是你没进入项目目录，或者没激活虚拟环境。请确认当前目录结构中是否有 manage.py 文件。
问题 2：访问页面出现 “Page not found (404)” 错误
👉 答：可能是 URL 配置有误。检查 urls.py 是否正确设置了路径，确保路径与浏览器地址匹配。
问题 3：安装 Django 提示权限不足怎么办？
👉 答：尝试在命令前加上 sudo（macOS/Linux），或以管理员身份运行命令提示符（Windows）。
问题 4：忘记激活虚拟环境怎么办？
👉 答：直接再次运行激活命令即可，不激活不会影响 Django 功能，但容易引起依赖冲突。
学习建议：下一步学习路线图
你已经完成了自己的第一个 Django 项目 🎉 接下来可以怎么继续学习呢？
建议一：学数据库和模型
试试创建一个博客系统，用数据库来保存文章内容。关键知识点包括：
- 使用
models.Model定义数据结构 - 使用
makemigrations和migrate更新数据库
建议二：学习模板语法
让你的网页变得更好看，掌握：
- HTML + CSS 基础
- Django 模板标签
{% %}和变量{{ }}
建议三：实现用户注册/登录
进阶知识，涉及：
- 表单处理
forms.Form - 用户认证系统
auth.User - session 和 cookie 的基本使用
建议四：部署上线
当你做好一个小项目，试着把它发布到网上：
- 使用免费平台如 pythonanywhere.com
- 学习 Gunicorn + Nginx 部署流程（适合进阶）
结语：编程是一个旅程，现在只是开始！
你现在已经掌握了如何创建一个简单的网站，但这只是冰山一角。Django 还有很多好玩又实用的功能等着你去探索。
只要坚持动手练习，不要害怕犯错，你一定能越来越熟练。记住一句话：
每一个大牛程序员，都曾经像你一样从“Hello World”开始！
如果你喜欢这篇文章，不妨收藏+转发给正在学习编程的朋友，我们一起进步 💪
本文约2038字，适合初学者循序渐进掌握 Django 基础知识。希望你从此迈出编程第一步！
评论 0