Django入门教程：搭建你的第一个Python网站
开篇：Django是什么？用来做什么？
在开始学习之前，我们先简单了解一下什么是 Django。
Django 是一个用 Python 编写的开源 Web 框架（Web Framework），它帮助你快速开发功能强大的网站。它的口号是：“让开发者专注于写代码，而不是重复的工作。”
你可以用 Django 来做：
- 博客系统
- 网络论坛
- 新闻网站
- 内容管理系统（CMS）
- 数据展示平台（比如统计图表页面）
一句话总结：如果你会写 Python，又想做个网站，那就用 Django！
环境准备：搭建开发环境
第一步：安装 Python
在开始前，请确保你已经在电脑上安装了 Python 3.8 或以上版本。
打开命令行（Windows 上叫 CMD、PowerShell；Mac 和 Linux 叫 Terminal），输入：
python --version
如果看到类似 Python 3.x.x 的输出，就说明已经装好了 Python。
如果没有装好，可以去官网下载安装包：https://www.python.org/
⚠️ 注意：在安装时勾选 “Add to PATH”，方便以后直接用命令行操作。
第二步：安装 Django
Django 需要用 pip 安装。pip 是 Python 的包管理工具，和 App Store 类似，可以下载各种库。
输入以下命令安装最新稳定版的 Django：
pip install django
验证是否安装成功：
django-admin --version
如果显示了一个数字（如 4.2.0），那就表示安装成功啦！
核心概念：Django 中的关键角色
为了更好地理解接下来的操作，我们要了解几个 Django 最基础的概念。不用担心，我都会用最通俗的语言来解释。
🧱 1. 项目（Project）
项目就是一个完整的网站。就像盖房子一样，项目是整个建筑的基础结构。通常包含多个“应用”。
比如：你要做一个博客网站，那整个这个网站就是一个项目。
🏘️ 2. 应用（App）
一个 Django 项目可以包含多个“小块”叫做应用。每个应用负责一个具体的功能模块。
比如：一个博客网站项目可能包含这些应用：
- 用户登录模块
- 文章发布模块
- 评论模块
每一个功能都可以封装成一个独立的应用。
📄 3. 模型（Model）
模型就是数据库里的表格，用来存储数据。比如文章表、用户表、评论表等。
比如文章的内容、标题、发布时间，都存在数据库中，而 Django 提供了一个很简单的机制让我们定义这些表格。
📍 4. URL 路由（URL Routing）
URL 就是你访问网页时候浏览器地址栏中的内容，例如：http://example.com/contact。
在 Django 中，我们可以把不同的网址指向不同的函数或页面。这叫做“路由”。
🖼️ 5. 模板（Template）
模板就是网页的 HTML 文件。Django 支持动态渲染内容到 HTML 页面中。这样我们就可以根据不同情况展示不同的信息。
💬 6. 视图（View）
视图是一个 Python 函数或类，它负责处理用户的请求，比如收到一个访问 /about/ 的请求后返回一个页面。
实战项目：一步步创建你的第一个 Django 网站
我们将从头开始创建一个极简的个人首页网站：访问 / 显示欢迎语，访问 /about/ 显示关于页面。
步骤 1：创建一个项目（Project）
使用下面的命令创建一个新的项目：
django-admin startproject mysite
执行后会在当前目录下生成一个文件夹 mysite，里面是 Django 的默认项目结构。
进入项目文件夹：
cd mysite
运行服务器，看看网站能不能跑起来：
python manage.py runserver
现在打开浏览器访问：http://127.0.0.1:8000，你会看到欢迎页，恭喜你，网站成功启动啦！
步骤 2：创建第一个应用（App）
回到终端（Ctrl+C 停止服务器），然后输入：
python manage.py startapp homepage
你会看到多了一个名为 homepage 的目录。
这个 app 专门负责主页相关内容。
步骤 3：注册你的应用
为了让 Django 知道你要用 homepage 这个应用，需要在 mysite/settings.py 文件中添加它。
找到 INSTALLED_APPS 列表，加入你的应用：
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
# 我们新添加的应用
'homepage',
]
保存文件，继续下一步。
步骤 4：编写第一个网页（视图 + 模板）
✅ 创建视图函数
打开 homepage/views.py 文件，写入以下内容：
from django.shortcuts import render
from django.http import HttpResponse
def index(request):
return HttpResponse("你好，这是我的主页！")
def about(request):
return HttpResponse("这是一个关于页面。")
这段代码的意思是：当有人访问我们的主页 / 或者 /about/ 的时候，分别显示不同的内容。
✅ 配置 URL 路由
接着我们配置访问路径。
在 homepage 目录下新建一个文件，名字是：urls.py，然后写入：
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
path('about/', views.about, name='about'),
]
然后，在项目级别的路由文件 mysite/urls.py 中引入这个应用的路由：
from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('homepage.urls')),
]
现在，当访问根目录 /，就会调用 homepage.urls 中对应的 view。
步骤 5：运行并查看效果
回到终端，再次启动服务器：
python manage.py runserver
打开浏览器访问：
- http://127.0.0.1:8000 —— 你会看到 “你好，这是我的主页！”
- http://127.0.0.1:8000/about —— 显示 “这是一个关于页面。”
🎉 成功！这是你的第一个 Django 页面！
常见问题解答（FAQ）
❓Q1：为什么我访问不了 /about/ 页面？
检查是否忘记注册 urls.py：
- 是否在应用中建立了
urls.py - 是否在主项目 urls.py 中使用了
include()
❓Q2：修改完代码为什么没生效？
Django 的开发服务器支持自动刷新。但有时可能不生效，建议重启服务器：
Ctrl + C # 停止服务
python manage.py runserver # 再次启动
❓Q3：为什么不能创建项目或应用？
确保你是在正确的目录下执行命令。比如：
startproject应该在你想存放项目的父目录下执行。- 如果提示找不到命令，确认是否正确安装了 Django。
❓Q4：我想返回 HTML 页面怎么办？
可以用模板引擎（后面会学到）来实现，或者像下面这样直接返回 HTML 内容（仅做演示）：
def index(request):
html = "<h1>欢迎来到我的主页</h1><p>这是一个HTML格式的页面。</p>"
return HttpResponse(html)
学习建议：下一步怎么学？
恭喜你完成了第一个 Django 网站！你现在拥有了：
- 创建项目的技能
- 创建应用的能力
- 理解 URL、视图的基本作用
- 初步了解如何响应浏览器请求
接下来你可以尝试：
✅ 练习 1：使用模板（Templates）
将上面例子改成使用 HTML 模板的形式，提升页面美观度。
✅ 练习 2：添加样式和图片（静态文件 Static Files）
给你的网站加上 CSS 样式，甚至背景图。
✅ 练习 3：连接数据库（使用 Model）
比如创建一个 "Article" 模型，让你能展示文章列表。
✅ 推荐学习路线图：
- 模板 Template → 动态页面
- 表单 Form → 获取用户输入
- 数据库 Model → 存储数据
- Admin 后台 → 管理自己的网站内容
- 用户登录认证 → 更复杂的交互
- 部署上线 → 把网站放到互联网上
结语：坚持实践才是真本领！
编程不是听懂，而是写出来。不要怕写错代码。你每犯一次错误，其实是在变得更聪明。
记住一句话：“程序员不是不会犯错，而是知道怎么解决问题。”
所以，从今天起，动手写你的第一个 Django 网站吧！你已经比昨天的自己更接近一名真正的程序员了！
🚀 愿你写出属于自己的精彩网站！
评论 0