Django入门教程：搭建你的第一个Python网站
开篇：Django 是什么？能做什么？
Django 是一个基于 Python 的Web 开发框架。你可以把它理解为“搭积木的工具包”，它提供了一整套已经写好的功能模块，帮你快速搭建出一个完整的网站。
简单来说，如果你想要：
- 做一个博客网站
- 实现用户注册登录
- 构建一个数据管理系统（如库存、订单等）
- 提供 API 接口给前端或其他系统调用
Django 都可以帮助你完成这些任务，而且效率非常高。
环境准备：让你的电脑准备好开发工作
在开始之前，我们先来配置好最基本的开发环境。
1. 安装 Python
确保你的电脑上安装了 Python 3.8 或以上版本。
检查是否安装成功：
python --version
如果没有安装，请到 官网下载最新版。
2. 创建虚拟环境（推荐）
虚拟环境就像是一个独立的小房间，专门用来放你的项目依赖，不会与其他项目冲突。
创建一个文件夹来存放你的项目：
mkdir myproject
cd myproject
然后创建虚拟环境：
python -m venv venv
激活虚拟环境（不同系统命令略有不同）：
- Windows：
venv\Scripts\activate - macOS/Linux：
source venv/bin/activate
你会看到命令行前面多了一个 (venv)，表示你已经进入虚拟环境。
3. 安装 Django
在激活虚拟环境后，输入以下命令安装 Django：
pip install django
安装完成后，可以用下面命令查看版本号，确认是否安装成功：
django-admin --version
核心概念：五个词让你看懂 Django
对于新手而言，Django 一开始可能有点抽象。我们先来了解它的几个核心概念：
| 概念 | 解释 |
|---|---|
| 项目（Project） | 相当于整个网站的总目录，包含多个应用 |
| 应用（App） | 每个具体的功能模块，比如“文章”、“用户中心” |
| 视图（View） | 处理请求、返回响应，相当于“大脑” |
| 模板（Template） | 控制网页显示的内容（HTML 页面） |
| 路由（URLconf） | 把网址和视图函数联系起来 |
这五个是构建 Django 网站的基本砖块，我们将在实战中逐个学习它们。
实战项目：从零开始做一个“Hello World”网页
我们将用 Django 创建一个最简单的网页：当你访问 http://localhost:8000 时，页面显示 “Hello, world!”
第一步：创建一个新项目
在终端中运行：
django-admin startproject helloworld
这会生成一个名为 helloworld 的项目文件夹，结构如下：
helloworld/
│
├── manage.py # 用于管理项目的脚本
└── helloworld/
├── __init__.py # 标志这是一个 Python 包
├── settings.py # 整个项目配置
├── urls.py # 项目的主路由
└── wsgi.py # 部署服务相关文件
第二步：运行服务器测试
进入项目目录，并启动内置服务器：
cd helloworld
python manage.py runserver
打开浏览器，访问：http://localhost:8000，你会看到一个欢迎页。
✅ 成功！说明你的 Django 项目已经运行起来了！
第三步：创建你的第一个页面
我们要让这个页面输出“Hello World”。
1. 编辑视图文件
找到并打开 helloworld/views.py 文件，添加以下代码：
from django.http import HttpResponse
def hello_world(request):
return HttpResponse("Hello, world!")
这段代码定义了一个视图函数，接收一个请求（request），返回一段文字响应。
2. 添加 URL 映射
编辑 helloworld/urls.py，修改内容如下：
from django.urls import path
from . import views
urlpatterns = [
path('', views.hello_world, name='home'),
]
这段代码把根路径 / 和我们刚写的 hello_world 函数关联起来。
3. 运行服务器，刷新页面
再次运行服务器：
python manage.py runserver
再刷新浏览器，这次你应该看到：
Hello, world!
恭喜你！你已经写出了第一个 Django 页面！
常见问题：新手容易遇到的问题与解决方法
❓ Q1：运行 runserver 时报错 ImportError: no module named django
💡 原因：Django 没有正确安装或者没有激活虚拟环境
✅ 解决方案：
- 先检查是否激活了虚拟环境（命令行是否有 (venv) 前缀）
- 再执行安装命令：
pip install django
❓ Q2：页面提示“Page not found”或报 404 错误
💡 原因：路径配置不正确
✅ 解决方案：
- 确保
urls.py中的path是' '（空字符串）对应首页 - 如果访问的是别的路径，比如
/about/，也要确保该路径有对应视图函数
❓ Q3：保存了代码但页面没有变化
💡 原因：可能是服务器未重启
✅ 解决方案：
- 终端按
Ctrl + C停止服务器 - 再重新运行：
python manage.py runserver
❓ Q4：如何退出虚拟环境？
💡 使用命令：
deactivate
学习建议：下一步学什么？
完成了第一个 Django 网站后，你已经有了一个很好的基础。接下来可以尝试学习：
✅ 第二课：使用模板显示 HTML 页面
学会用 .html 文件来展示更美观的网页，不再只是输出纯文本。
示例：创建一个 templates/home.html，并在视图中使用：
from django.shortcuts import render
def home(request):
return render(request, 'home.html', {'name': 'World'})
✅ 第三课：使用数据库（模型 Models）
学习如何用 Django 与数据库打交道，比如存储用户信息、文章内容等。
示例：创建一个文章模型：
from django.db import models
class Article(models.Model):
title = models.CharField(max_length=100)
content = models.TextField()
然后运行数据库迁移命令：
python manage.py makemigrations
python manage.py migrate
✅ 第四课：创建管理员后台
Django 自带强大的后台管理功能，只需两步即可开启：
创建超级用户：
python manage.py createsuperuser在
admin.py中注册模型：from django.contrib import admin from .models import Article admin.site.register(Article)
访问后台地址：http://localhost:8000/admin
✅ 第五课：部署上线
当你本地项目完成后，可以把网站放到网络上供大家访问。常见方式包括：
- 使用 PythonAnywhere
- 用服务器 + Nginx + Gunicorn 搭建
- Docker 容器部署（进阶）
结语：继续前进，成为真正的开发者！
通过这篇教程，你已经迈出使用 Django 的第一步。记住：
不要怕犯错，要怕不敢动手。
每一个专业程序员，都是从 Hello World 开始的。现在你已经站在了同一起跑线上。继续坚持学习，大胆实践，你一定可以在编程世界里走出自己的道路。
Happy coding! 👨💻✨
评论 0