如果你已经学习了一些Python基础知识，但在尝试构建实际项目时仍然感到无从下手，那么你并不孤单。许多初学者都会先学习教程，了解变量、函数和循环等概念，但当真正尝试创建一个项目时就会遇到障碍。
从“我知道Python语法”到“能够开发出一个可运行的Web应用”，这个差距可能会让人觉得非常大。但实际上，这种差距并非不可避免。
在这个教程中，你将使用Django这一非常流行的Python Web框架，从零开始构建一个健身追踪Web应用。完成学习后，你将会拥有一个可以在互联网上正常运行的完整应用程序——你可以把它展示给朋友看，添加到自己的作品集里，或者继续在此基础上进行开发。
你将学到以下内容：
-
Django项目及其应用的架构结构
-
如何定义数据库模型来存储锻炼数据
-
如何创建处理用户请求的视图函数
-
如何编写用于显示数据的HTML模板
-
如何将URL与视图函数关联起来，以便用户能够浏览你的应用
-
如何将完成的应用程序部署到PythonAnywhere上，让任何人都能访问它
这个应用程序本身非常简单：你可以通过输入运动名称、持续时间以及日期来记录一次锻炼情况，然后可以在另一个页面上查看所有记录下来的锻炼信息。虽然很简单，但它涵盖了构建更复杂应用所需的核心Django概念。
让我们开始吧。
目录
先决条件
在开始之前，请确保您已经掌握了以下内容：
Python基础知识：您需要了解变量、函数、列表、字典以及基本的控制结构（如if/else语句和循环）。
基本命令行使用方法：在本教程中，您需要在终端中执行各种命令。您应该知道如何打开终端、在文件夹间切换以及运行命令。如果在Windows系统中，可以使用命令提示符或PowerShell；在macOS或Linux系统中，默认的Terminal应用程序也能满足需求。
需要安装的工具：
-
Python 3.8或更高版本。您可以通过在终端中运行
python --version或python3 --version来检查自己的Python版本。如果还没有安装Python，可以从python.org下载。 -
pip。这是Python的包管理工具，通常会随Python一起安装。您可以通过运行
pip --version或pip3 --version来验证它的存在。注意，命令python3和pip3表示您正在使用Python 3版本。 -
代码编辑器。Visual Studio Code是一个非常优秀的免费选择，但您也可以使用任何自己熟悉的编辑器。
以上就是全部准备内容。您不需要具备Django的使用经验或网页开发知识，本教程会一步步引导您完成学习过程。
您将构建什么
您将要开发的这个健身追踪工具具有以下两个主要功能：
- 用于记录锻炼信息的表单。您可以在其中输入运动名称（例如“跑步”或“俯卧撑”）、运动时长（以分钟为单位）以及日期。提交表单后，Django会将这些信息保存到数据库中。
- 用于查看所有锻炼记录的页面。该页面会以清晰明了的方式列出您所记录的所有锻炼信息，包括运动类型、时长和日期。
从高层次来看，数据在应用程序中的流动过程如下：
-
您在浏览器中填写锻炼记录表单并点击提交。
-
您的浏览器会将这些数据发送给Django。
-
Django的视图函数会接收这些数据，对其进行验证，然后将其保存到数据库中。
-
当您访问锻炼记录页面时，Django的视图函数会从数据库中检索所有已保存的锻炼记录。
-
Django会将这些数据传递给HTML模板，模板会将它们渲染成浏览器可以显示的页面。
这种请求-响应机制是Django框架运作的基础。一旦你理解了这一原理，那么你几乎可以构建任何类型的应用程序。
步骤1：如何设置你的Django项目
每个Django项目在开始时都需要进行一些初始化设置。你需要创建一个独立的Python环境，安装Django框架，并生成项目的基本结构文件。
1.1 如何创建虚拟环境
虚拟环境是一个独立的文件夹，其中包含了专门为某个项目准备的Python解释器及已安装的软件包。这样的设置能够将你的项目所依赖的组件与电脑上其他Python项目分开来，从而避免版本冲突，并确保各种配置的一致性。
例如，有的项目可能需要使用较旧版本的Django框架，而另一个项目则必须使用最新版本；虚拟环境的存在使得这两个项目能够在同一系统中顺利运行。
如果没有虚拟环境，全局安装的软件包之间可能会发生冲突，从而导致项目无法正常运行，同时也会使配置过程变得复杂且难以重复。随着时间的推移，系统环境会逐渐充斥着那些未被使用或不兼容的软件包，进而增加调试和维护的难度。
现在，我们就来开始设置虚拟环境吧。
打开终端，导航到你想要存放项目的文件夹位置，然后执行以下命令：
mkdir fitness-tracker
cd fitness-tracker
第一个命令用于创建一个名为“fitness-tracker”的新文件夹，第二个命令则会将当前目录切换到这个新文件夹中。
你将在这里创建Python虚拟环境。
python3 -m venv venv
上述命令会在名为“venv”的文件夹中创建一个虚拟环境。“python3 -m venv venv”这个命令中，第一个“venv”是命令本身，第二个“venv”则是该虚拟环境的名称。其实你可以给这个文件夹起任何名字，不过通常人们还是习惯使用“venv”这个名称。
通过执行“ls”命令，你可以确认虚拟环境文件夹确实已经创建成功了。
要激活这个虚拟环境，需要执行以下命令：
在macOS/Linux系统上：
source venv/bin/activate
在 Windows 上：
venv\Scripts\activate
当你在终端提示符的前面看到 (venv) 时，就说明激活成功了。从这时起，你安装的任何 Python 包都只会存在于这个 虚拟环境中。
1.2 如何安装 Django
在虚拟环境激活后，使用 pip 来安装 Django：
pip install django
这样就会下载并安装最新版本的 Django。你可以通过运行以下命令来验证安装是否成功：
python3 -m django --version
执行完这两条命令后，你应该会看到 Django 已经被安装完毕，同时也会显示其版本号：
1.3 如何创建项目
Django 的安装已经完成，现在我们来创建一个 Django 项目。Django 提供了一个命令行工具，可以生成你需要的模板文件。请输入以下命令：
django-admin startproject fitness_project .
这条命令会创建一个名为 fitness-project 的文件夹。注意命令末尾的那个点，这个点非常重要——它告诉 Django 在当前目录中生成项目文件，而不会创建额外的嵌套文件夹。
现在我们的 Django 项目已经创建好了，接下来让我们在喜欢的文本编辑器中打开这个项目，看看它的文件夹结构。
你会发现这个文件夹里已经包含了很多文件了。
1.4 如何运行开发服务器
现在让我们确认一下所有设置是否都正常工作。为此，你需要运行一个服务器。请输入以下命令：
python manage.py runserver
你可以在激活了虚拟环境的终端中输入这条命令，或者如果你使用的是 VS Code，也可以使用其内置的终端。从现在开始，我将会使用内置终端来操作。
打开您的浏览器，访问http://127.0.0.1:8000/。您应该会看到Django的默认欢迎页面，页面上还会显示一枚火箭图案，这证明您的项目已经设置正确。
当您准备继续下一步操作时，请在终端中按下Ctrl + C来停止服务器。
步骤2：如何创建Django应用程序
在Django中，项目是整个Web应用程序的总体框架，而应用程序则是该项目中的一个小模块，它专注于实现特定的功能。
用一个房子来打比方会更容易理解这一点：整个房子就是项目，而房子里的每个房间则对应着应用程序。其中一个房间可能是厨房，另一个可能是卧室，每个房间的设计都有其明确的用途。同样地，Django应用程序也是为完成某一项特定任务而开发的，比如身份验证、支付处理，或者像在这个例子中那样，用于记录锻炼情况。
现在来看看关键点：为什么不把所有功能都放在一个项目中呢？技术上来说，这是可行的，尤其是对于非常小的项目而言。但随着应用程序规模的扩大，这种做法很快就会变得难以管理。
通过使用应用程序，我们可以自然地将不同的功能区分开来。这样也能让协作变得更加顺畅，因为不同的人可以分别负责不同的应用程序，而不会经常干扰到彼此的代码。
另一个重要的好处是代码的可重用性。由于应用程序都是模块化的，因此我们可以将某个应用程序从一个项目中提取出来，然后重新用在另一个项目中。
例如，如果您曾经开发过一个用于记录锻炼情况的应用程序，之后就可以将其直接应用到另一个完全不同的Django项目中，而无需从头开始重新编写代码。后来，如果您又创建了一个新的项目，比如一个健身辅导平台或健康监测工具，那么您仍然可以重复使用之前那个记录锻炼功能的应用程序。
对于这个项目来说，您将创建一个名为tracker的应用程序，它将负责处理与记录和显示锻炼数据相关的所有功能。
2.1 如何生成应用程序
请确保您当前所处的目录与manage.py文件位于同一位置，然后运行以下命令：
python manage.py startapp tracker
这条命令会创建一个名为“tracker”的新文件夹，该文件夹的结构如下所示：
这些文件各自有着不同的用途。在整个项目中，您将会经常使用models.py、views.py和admin.py这三个文件。
2.2 如何注册应用程序
Django并不会自动识别你的新应用程序。你需要通过将该应用程序添加到《settings.py》文件中的`INSTALLED_APPS`列表中来告知它。
打开《fitness_project/settings.py》，找到`INSTALLED_APPS`列表。在列表末尾添加该应用程序的名称，即`tracker`：
你会注意到，Django已经自动安装了一些应用程序。这体现了Django“开箱即用”的设计理念——许多常用功能都可以直接使用。
以下是这些应用程序各自的功能简介。
| 应用程序名称 | 用途 |
|---|---|
| django.contrib.admin | 用于管理内置的管理员控制面板，可通过网页界面来操作数据。 |
| django.contrib.auth | 负责处理用户账户、登录系统、权限设置以及密码管理功能。 |
| django.contrib.contenttypes | 帮助Django追踪并管理不同模型之间的关系。 |
| django.contribsessions | 用于存储用户会话数据，使用户在多次请求之间保持登录状态。 |
| django.contrib.messages | 允许显示临时通知信息，如成功或错误提示。 |
| django.contrib.staticfiles | 用于管理CSS、JavaScript文件以及图片等静态资源。 |
现在，Django已经知道你的`tracker`应用程序存在了，在运行项目时也会包含它。
步骤3：如何创建锻炼模型
在Django中，模型是一种Python类，用于定义数据的结构。每个模型都会直接对应数据库中的一张表，模型中的每个属性都会成为该表中的一列。
可以把模型想象成电子表格的蓝图——类名就是电子表格的名称，而每个字段则相当于列标题。每当你保存一次新的锻炼记录时，Django就会在电子表格中添加一行新数据。
3.1 如何定义模型
打开《tracker/models.py》，将其内容替换为以下代码：
from django.db import models
class Workout(models.Model):
activity = models.CharField(max_length=200)
duration = models.IntegerField(help_text="持续时间，单位为分钟")
date = models.DateField()
def __str__(self):
return f"{self.activity} - {self.duration}分钟，在{self.date}进行"让我们来了解一下每个部分的功能：
-
activity = models.CharField(max_length=200)这个代码用于创建一个文本字段，最多可以存储200个字符。你可以在这里输入锻炼的名称，比如“跑步”或“骑自行车”。 -
duration = models.IntegerField(help_text="持续时间（以分钟为单位）")这个代码用于创建一个整数字段，用来记录锻炼持续了多少分钟。help_text参数会添加一条提示信息，这些提示会显示在表单和管理员面板中。 -
date = models.DateField()这个代码用于创建一个日期字段，用来记录锻炼发生的具体时间。
__str__()方法决定了当打印或在管理员面板中显示时，“Workout”对象会以什么样的形式呈现。这样一来，你看到的就不会是像“Workout object (1)”这样的无意义信息，而是“跑步——2025-03-15，持续30分钟。”
步骤4：如何应用迁移文件
你已经定义了模型结构，但Django还没有实际创建相应的数据库表。要想完成这一操作，你需要运行迁移命令。
迁移文件是Django将你的Python模型定义转换为数据库指令的一种方式。执行迁移分为两个步骤。
当你修改某个模型时——无论是添加字段、删除字段还是更改字段名称——都需要创建一个新的迁移文件来描述这些变更。你可以使用makemigrations命令来完成这个操作。
之后，你需要使用migrate命令来应用这些迁移文件，Django会自动更新数据库结构以匹配新的模型定义。
这种先检测变更、再应用变更的两步流程，能够确保你能够准确记录数据库结构随时间发生的所有变化。
4.1 如何生成迁移文件
在集成终端中运行以下命令：
python manage.py makemigrations
你应该会看到如下输出结果：
Migrations for 'tracker': tracker/migrations/0001_initial.py
+ Create model Workout
Django已经检查了你的“Workout”模型，并生成了一个迁移文件，该文件详细说明了如何创建相应的数据库表。如果你想查看这个文件，可以找到它的位置是tracker/migrations/0001_initial.py，不过你不需要手动编辑它。
4.2 如何应用迁移文件
现在，让Django执行这个迁移命令，从而在数据库中创建相应的表：
python manage.py migrate
在执行迁移过程中，你会看到多行输出信息。因为Django不仅会应用你自定义的迁移文件，还会应用Django内置应用程序所对应的默认迁移文件（比如认证系统、会话管理等）。
当迁移操作完成之后，你的数据库中就会有一个专门用于存储训练记录的表格。
当执行`migrate`命令时，我们可以看到Django实际使用了哪些SQL语句来构建和修改数据库结构。虽然了解这些细节对于创建应用程序来说并非必需，但了解底层发生的操作过程总是有益的。
请运行以下命令：
python manage.py sqlmigrate tracker 001你应该会得到如下输出结果：
你在命令末尾添加的`001`表示迁移的编号，它代表数据库模式的第一个版本。
在实际开发中，你的工作流程通常会是这样的：先修改模型结构，然后运行`makemigrations`命令生成迁移文件，最后执行`migrate`命令将这些变更应用到数据库中。
步骤5：如何在管理面板中注册模型
Django内置了一个功能强大的管理界面。通过这个界面，你可以无需编写任何额外代码，就能以图形化的方式查看、添加、编辑或删除数据库中的记录。在开发过程中，这一功能非常实用，因为你可以快速测试模型并查看数据情况。
但是，默认情况下，Django并不知道：
-
你想要管理哪些模型
-
你希望这些模型以什么样的方式显示出来
因此，你需要通过`admin.py`文件来注册这些模型，这样Django才会将它们包含在管理界面中。
5.1 如何将模型添加到管理界面
打开`tracker/admin.py`文件，并添加以下代码：
from django.contrib import admin
from .models import Workout
admin.site.register(Workout)
这一行代码告诉Django，要将`Workout`模型包含在管理界面中。
5.2 如何创建超级用户
要访问管理面板，你需要一个超级用户账户。运行以下命令来创建一个：
python manage.py createsuperuserDjango会要求你输入用户名、电子邮件地址和密码。请选择容易记住的信息。电子邮件地址是可选的——你可以直接按Enter键跳过这一步骤。
5.3 如何访问管理面板
启动开发服务器：
python manage.py runserver
然后在浏览器中访问 http://127.0.0.1:8000/admin/。使用你刚刚创建的用户名和密码进行登录。
你应该会看到 Django 管理面板，其中有一个“Tracker“板块，里面包含了你的“Workouts
试着点击“添加”按钮，创建几个测试用例。这样就可以确认你的模型运行是否正常，然后再继续开发应用程序的其他部分。 在 Django 中，视图是一种 Python 函数或类，它接收 Web 请求并返回相应的 Web 响应。这个响应可以是 HTML 页面、重定向链接、404 错误信息，或是浏览器能够处理的任何其他内容。 视图是应用程序逻辑的核心所在。它们决定了需要获取哪些数据、进行哪些处理，以及最终向用户展示什么内容。 对于这个应用程序来说，你需要创建两个视图：一个用于显示让用户添加训练记录的表单，另一个用于显示所有已保存的训练记录列表。 在编写视图之前，首先需要一个能够处理用户输入数据的 Django 表单。 Django 表单是一种内置的功能，用于处理各种用户输入数据，比如登录表单、联系表单，或是任何收集用户信息的表单。使用 Django，你无需手动编写 HTML 代码、验证用户输入或处理错误信息，而是可以通过结构化的方式一次性完成这些工作。 大多数用户输入数据都是基于你创建的模型，而 Django 可以利用 ` 让我们在 `tracker` 文件夹中创建一个名为 `forms.py` 的新文件，并添加以下代码： 在上面的代码中， 我们实际上可以看到Django是如何自动创建这些表单的。为此，我们需要进入shell环境。在终端中输入以下命令： 现在，让我们导入我们刚刚创建的 输入以下代码： 请注意，在导入表单类时，我们也指定了应用程序的名称。 然后创建一个 你应该会得到如下输出： 你可以看到，所有的模型字段都被渲染成了HTML表单形式，而日期字段也被设置为 正如我们上面所讨论的，我们的项目有两个视图函数：一个用于添加锻炼记录，另一个用于显示所有已保存的锻炼记录。 首先，让我们创建一个用于添加锻炼记录的视图函数。在 让我们来详细分析这个视图函数的功能： 它会从数据库中检索所有的 要创建用于添加锻炼记录的逻辑，首先需要在导入代码段的末尾添加对 当用户首次访问该页面时，请求方法为GET，因此Django会生成一个空白表单并将其呈现给用户。 当用户填写完表单并点击“提交”按钮时，请求方法变为POST。此时Django会验证用户提交的数据，如果数据无误，则会将这些数据保存到数据库中，并将用户重定向到锻炼记录列表页面。 如果提交的数据无效，Django会重新显示表单，并在表单中显示错误信息。 以下是完整的视图函数代码： 模板文件是HTML格式的文件，Django会使用动态数据来填充这些文件。它们构成了你的应用程序的用户界面部分，也就是用户在实际浏览器中看到的内容。 Django会在每个应用程序内部的 “tracker”这个双层文件夹名称看起来可能有些冗余，但实际上这是 Django 中的一种约定，被称为模板命名规范。这种规范能够避免在多个应用程序中使用相同文件名来存储模板时出现命名冲突的问题。 创建一个名为 目前还没有任何锻炼记录。请先添加一条吧！
步骤 6：如何为应用程序创建视图
6.1 如何创建表单类
ModelForms` 自动根据这些模型生成表单，从而大大提高开发效率。from django import forms
from .models import Workout
class WorkoutForm(forms.ModelForm):
class Meta:
model = Workout
fields = ['activity', 'duration', 'date']
widgets = {
'date': forms.DateInput attrs={'type': 'date'],
}
ModelForm会根据Workout模型自动生成表单字段。widgets字典告诉Django将日期字段渲染为HTML日期选择器，而不是纯文本输入框。python manage.py shell
WorkoutForm类。from tracker.forms import WorkoutForm
WorkoutForm类的对象，并将其打印出来。from tracker.forms import WorkoutForm
workoutform = WorkoutForm()
print(workoutform)
type="date"类型，而不是纯文本。6.2 如何编写视图函数
tracker/views.py文件中，输入以下代码：from django.shortcuts import render, redirect
from .models import Workout
# 用于列出所有锻炼记录的视图函数
def workout_list(request):
workouts = Workout.objects.all().order_by('-date')
return render(request, 'tracker/workout_list.html', {'workouts': workouts})
workout_list视图负责显示所有锻炼记录的页面。Workout对象，按照日期对这些对象进行排序（由于使用了-前缀，因此最新的记录会排在最前面），然后将这个列表传递给名为workout_list.html的模板。render函数会将模板与检索到的数据结合在一起，最终生成完整的HTML页面并返回出来。Workout表的导入语句。然后，在workout_list视图之后添加以下代码：from django.shortcuts import render, redirect
from .models import Workout
from .forms import WorkoutForm
# 用于列出所有锻炼记录的视图函数
def workout_list(request):
workouts = Workout.objects.all().order_by('-date')
return render(request, 'tracker/workout_list.html', {'workouts': workouts})
# 用于添加锻炼记录的视图函数
def add_workout(request):
if request.method == 'POST':
form = WorkoutForm(request.POST)
if form.is_valid():
form.save()
return redirect('workout_list')
else:
form = WorkoutForm()
return render(request, 'tracker/add_workout.html', {'form': form})
add_workout视图函数既负责显示空表单，也负责处理用户提交的表单数据。from django.shortcuts import render, redirect
from .models import Workout
from .forms import WorkoutForm
# 用于列出所有锻炼记录的视图函数
def workout_list(request):
workouts = Workout.objects.all().order_by('-date')
return render(request, 'tracker/workout_list.html', {'workouts': workouts})
# 用于添加锻炼记录的视图函数
def add_workout(request):
if request.method == 'POST':
form = WorkoutForm(request.POST)
if form.is_valid():
form.save()
return redirect('workout_list')
else:
form = WorkoutForm()
return render(request, 'tracker/add_workout.html', {'form': form})
步骤7：如何创建模板文件
7.1 如何设置模板目录
templates文件夹中查找模板文件。请在你的tracker应用程序中创建如下文件夹结构：tracker/templates/tracker
7.2 如何创建锻炼列表模板
tracker/templates/tracker/workout_list.html的文件，然后添加以下代码：<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
我的锻炼记录
+ 添加新的锻炼记录
{% if workouts %}
{% for workout in workouts %}