0
0
0

Django入门教程：搭建你的第一个Python网站

开发者小宇宙
2025-06-15 02:51
阅读 678

开篇：Django是什么？我能用它做什么？

开篇：Django是什么？我能用它做什么？

Django 是一个用 Python 编写的Web框架，它的主要功能是帮你快速构建网站。就像搭积木一样，Django 给你提供了很多“模块”，你可以把这些模块组合起来，快速创建出功能强大的网站。

Web 框架就像是盖房子的脚手架。有了它，我们不需要从头开始搭每一面墙、装每一块砖，而是站在前人的基础上，专注建造自己的房间。

Django 适合用来做：

  • 博客系统（像博客园这样的）
  • 电商网站
  • 后台管理系统
  • 社交平台

它的特点是：“开箱即用” + “快速开发”。也就是说，很多常用功能（比如用户登录、后台管理）已经内置好了，我们只需要按需启用即可。

环境准备：搭建你的第一个 Django 工作环境

环境准备：搭建你的第一个 Django 工作环境

在写代码之前，我们需要先准备好开发环境。以下是详细的安装步骤：

1. 安装 Python

Django 是基于 Python 的，所以第一步就是确保你已经安装了 Python。

✅ 检查是否已安装：打开命令行（Windows 是 cmd，Mac/Linux 是终端），输入：

python --version

或者：

python3 --version

如果你看到了版本号（比如 Python 3.10.6），说明已经安装好了。

❌ 如果没有安装，请访问 Python官网 下载并安装（推荐 Python 3.8 及以上版本）。

📌 小贴士：安装时一定要勾选 "Add to PATH"，这样系统才能识别你的 Python 命令。

2. 安装 pip（Python 包管理工具）

pip 是 Python 中用来安装其他库的工具。我们通常用 pip 来安装 Django。

✅ 检查 pip 是否存在：

pip --version

或者：

pip3 --version

如果看到类似 pip 23.0.1 from ... 这样的信息，恭喜你，pip 已就绪！

3. 安装 Django

现在我们要通过 pip 安装 Django。

pip install django

等待几分钟下载完成，然后验证一下是否安装成功：

django-admin --version

输出应该是类似 4.2.5 这样的版本号。

4. 创建你的项目文件夹结构

我们来创建一个空的文件夹作为项目的根目录（也就是所有代码的存放位置）。例如，在桌面新建一个文件夹叫 my_django_site。

进入该文件夹后，执行以下命令：

django-admin startproject mysite .

此时你会看到这个目录下多了几个文件，它们是：

mysite/
    __init__.py
    settings.py
    urls.py
    wsgi.py
manage.py

这些是 Django 自动生成的基础配置文件，暂时不要修改它们。接下来我们会逐步讲解它们的作用。

核心概念：Django 的五个关键词解释

核心概念：Django 的五个关键词解释

在正式写代码之前，让我们先认识一些核心概念。不用担心记不住，后面都会用到：

1. Project（项目）

这相当于整个网站的整体工程，包含多个 App。例如一个电商网站是一个 Project，里面可能有商品管理、订单管理等多个功能模块。

✨类比：整栋大楼 = 项目；里面的每个楼层 = app

2. App（应用）

App 是功能模块。每个 App 负责一项具体的功能。Django 鼓励将不同功能拆分成多个 App，便于管理和维护。

举个例子：

  • blog 应用（负责写文章）
  • user 应用（处理用户注册与登录）
  • news 应用（展示新闻内容）

3. View（视图）

View 相当于是网页的内容生成器。它告诉服务器：当用户访问某个地址时，应该显示什么内容。

简单理解为：

  • 用户请求某个网址
  • View 接收这个请求
  • View 生成一个 HTML 页面或返回数据（如 JSON）
  • 返回给用户的浏览器

4. Template（模板）

Template 就是我们常说的 HTML 文件。它可以包含动态内容，比如当前用户名、当前时间等。View 渲染 Template 后发送给浏览器。

5. URL Router（路由）

URL 路由的作用是把用户访问的不同地址分配给对应的 View 处理。有点像电话客服系统的自动转接——不同的号码分发到不同部门去处理。

例如：

  • /home/ → 显示首页
  • /about/ → 显示关于我们页面
  • /contact/ → 显示联系表单

实战项目：动手做一个最简单的欢迎页面

API接口文档-1

实战项目：动手做一个最简单的欢迎页面

现在我们来实际操作一次。我们将一步一步搭建一个只显示“欢迎来到我的网站！”的简单网页。

第一步：创建一个 App

在你的项目目录下（也就是有 manage.py 的那个目录），运行：

python manage.py startapp home

这会创建一个名为 home 的新应用。你现在可以在文件夹中看到多了一个叫做 home/ 的目录。

别忘了还要把这个 App 添加进我们的项目中：

打开 settings.py，找到 INSTALLED_APPS 列表，在末尾加上：

'home',

⚠️ 注意：逗号不能少，否则会报错。

第二步：编写一个 View（视图函数）

打开 home/views.py 文件，把下面这段代码粘进去：

from django.http import HttpResponse

def index(request):
    return HttpResponse("欢迎来到我的网站！")

这是最简单的视图函数，它接收一个请求，返回一句欢迎语。

第三步：设置 URL 路由

接下来我们要告诉 Django，当用户访问 / 这个路径的时候，要调用刚刚写的 index 函数。

有两种方式可以实现，这里我们使用最简单的方式。

方法一：直接绑定

打开 mysite/urls.py 文件，导入 home.views：

from django.contrib import admin
from django.urls import path
from home import views  # 新增这一行

然后添加一条路径映射：

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.index),  # 访问根路径时调用 home 的 index 视图
]

保存文件。

第四步：启动服务器测试

回到终端，运行：

python manage.py runserver

你会看到输出中提示服务器正在运行。打开浏览器，访问地址：

http://localhost:8000

你应该能看到页面上显示出：

欢迎来到我的网站！

🎉 恭喜你，完成了你的第一个 Django 页面！

常见问题解答：新手最容易踩的坑都在这

数据流转过程-2

下面是一些新手常遇到的问题和对应的解决方法，帮你少走弯路：

❓Q1：启动服务时报错 cannot import name 'views' from 'home'

🔧原因：未正确引入视图函数或文件名错误
🛠解决方案：检查 urls.py 中是否有 from home import views 并确认 views.py 文件确实存在。

❓Q2：访问页面出现 404 或空白页

🔧原因：路径配置不正确或服务未重启
🛠解决方案：

  • 检查 urls.py 中 path() 的参数是否匹配。
  • 确保服务端口是 8000（默认）
  • 修改代码后必须重启服务才能生效

❓Q3：提示 ModuleNotFoundError: No module named 'django'

🔧原因：Django 没有正确安装
🛠解决方案：

  1. 确认你是使用哪个 Python 解释器安装的（例如 python3 还是 python）
  2. 尝试重新安装：pip install django
  3. 如果你在虚拟环境中，确认激活了虚拟环境

❓Q4：如何让样式显示更丰富？

🔧答：Django 本身只处理逻辑部分，样式要用 HTML/CSS/JS 实现。下一阶段可以学习模板系统（Templating System）和前端知识。

学习建议：下一步我应该怎么学？

恭喜你完成了第一个小项目！下面是一些推荐的学习路径，帮助你进一步掌握 Django：

1. 学习使用模板（Templates）

目前我们只是返回了字符串，如果你想显示一个完整的 HTML 页面，就要用到模板系统。可以尝试把上面的欢迎页面替换成一个 HTML 文件，并使用模板语法渲染内容。

推荐学习资源：

  • Django 官方文档中的模板部分
  • B站上的 Django 模板视频教程（中文）

2. 学习数据库模型（Models）

想让用户注册、发布文章？那就得学习模型。模型可以帮助你与数据库打交道，存储各种数据。

推荐任务：

  • 创建一个文章模型（Article）包含标题、正文和发布时间字段
  • 在后台界面中查看数据变化

3. 使用 Admin 后台管理功能

Django 自带一个非常方便的后台管理面板。只要几行命令就能为你的模型生成可视化管理界面。

学习路线建议：

  • 注册 Article 到 admin
  • 创建超级管理员账户：python manage.py createsuperuser
  • 登录后台编辑文章

4. 学习表单处理（Forms）

想让用户提交内容？比如评论、留言、注册？那你需要掌握 Django 表单功能。

建议练习：

  • 创建一个联系方式表单
  • 设置验证规则（如邮箱格式）

5. 进阶：部署上线

完成本地开发之后，你想让更多人访问怎么办？你需要学会把网站部署到线上服务器上。

学习方向建议：

  • 使用 PythonAnywhere、Heroku、阿里云、腾讯云等平台
  • 学习静态资源处理（CSS/图片/JS）
  • 使用 Gunicorn + Nginx 构建生产环境

总结

本教程带你从零开始，一步步搭建了一个最简单的网站。我们从安装 Django 到创建项目、应用、视图、路由，最后跑通了一个“欢迎页面”。

记住一句话：

学编程最好的方式就是边学边写，不怕犯错。

每一个高手都是从 hello world 写起的。继续加油吧！

如果你喜欢这篇教程，不妨把它收藏起来，当作今后学习的起点。也可以继续关注更多 Django 教程系列文章，让你真正掌握后端开发的能力。

标签:Python爬虫工具

评论 0

最热最新
暂无评论

为你推荐

暂无相关推荐
匿名用户Lv.1
0
影响力
0
文章
0
粉丝

相关推荐

暂无相关推荐

精选内容

暂无精选内容