Django 入门练习教程：直接开干做个疫情可视化地图…牛逼牛逼！

2022-08-0119:57:06后端程序开发Comments749 views字数 7385阅读模式

Django 是 Python web框架，发音 [ˈdʒæŋɡo] ，翻译成中文叫“姜狗”。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

为什么要学框架？其实我们自己完全可以用 Python 代码从0到1写一个web网站，但那样就要写网络服务、数据库读写等底层代码。而框架的作用是把这些底层基建已经搭建好了，我们只写业务逻辑即可。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

举个例子，楼房就是框架，我们不关心底层的脚手架、钢筋水泥是如何搭建的，只要有了这样的框架我们就可以住进去，而里面的房间要怎么设计、装饰才是我们关心的。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

1文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

初识Django文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

我使用的 python 版本是 3.8，先执行下面语句先安装 Django文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

pip install Django

安装完成后，执行下面语句创建 Django 项目文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

django-admin startproject duma文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

项目的名称可以自定义，我创建的项目名是 duma。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

命令执行完毕后，在当前目录会生成 duma 目录，该目录包含以下源文件。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

duma/
manage.py
duma/
__init__.py
settings.py
urls.py
asgi.py
wsgi.py

简单介绍下这几个文件的作用：文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

manage.py: 管理 Django 项目的命令行工具，就像一个工具箱，后面会经常用到
mysite/settings.py：django 项目的配置文件，如：配置该项目使用什么数据库、包含哪些应用等
mysite/urls.py：Django 项目的 URL 声明
mysite/asgi.py：作为你的项目的运行在 ASGI 兼容的 Web 服务器上的入口。暂时用不到
mysite/wsgi.py：作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。暂时用不到

后面的学习中，我们会使用、修改这上面的文件，那时候对他们的作用会有更深的体会。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

运行下面命令，启动web服务，验证 duma 项目是否创建成功。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

python manage.py runserver

执行命令，会看到有以下信息输出文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

Starting development server at http://127.0.0.1:8000/文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

在浏览器访问 http://127.0.0.1:8000/文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

看到上面的页面，说明项目创建成功。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

接下来我们要在 duma 项目中创建一个应用（app）。一个项目里可以有多个应用，如电商项目里可以有商城应用、支付应用和会员应用等等。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

执行这行命令，创建一个应用文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

python manage.py startapp ncov

这里创建了一个名为 ncov 的应用，用它来做一个疫情数据报告。项目根目录会发现有个 ncov 目录，包含以下文件文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

ncov/
__init__.py
admin.py
apps.py
migrations/
__init__.py
models.py
tests.py
views.py

先不介绍它们的作用，这些文件后面基本都会用到，到时候会详细介绍。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

2文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

Hello, World文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

“Hello, World” 是学习任何编程语言的演示程序，现在我们用 Django 实现一个“Hello, World” web应用。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

首先，在 “nocv/views.py” 文件中创建 index 函数文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

from django.http import HttpResponse


def index(request):
return HttpResponse('Hello, World!')

然后，在 ncov 目录中创建 urls.py 文件，它用来定义 ncov 应用包含的 url。如：在电商商城应用中，会有商城首页 url 和商品详情的 url。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

在 urls.py 文件中添加一个url，使之与 index 函数对应起来。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

from django.urls import path

from . import views

urlpatterns = [
path('', views.index, name='index'),
]

第一个参数是 url 的路径，这里是空字符串代表 ncov 应用的根路径；第二个参数是该 url 对应的视图；第三个参数是该 url 的名称，可自定义。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

最后，在 “duma/urls.py” 添加代码，将 ncov 应用的 url 注册到 duma 项目中，添加后的代码如下文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
path('admin/', admin.site.urls),
path('ncov/', include('ncov.urls')),

]

在浏览器访问 ncov 应用根路径 http://127.0.0.1:8000/ncov/文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

如果看到如上图的页面就代表成功了。如果启动的服务关闭了，需要在 duma 目录执行 python manager.py runserver 命令重新启动web服务。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

当访问 ncov 应用根路径的时候，浏览器会产生一个 http 请求，duma项目的web服务接到该请求后，根据 urls.py 中的配置，调用 “ncov/views.py” 文件的 index 函数来处理该请求，index 函数中用 HttpResponse 将字符串 “Hello, World” 构造为一个 http 响应结果并返回给浏览器，浏览器接到该响应结果后，在页面上显示 “Hello, World” 字符串。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

细心的话，你会发现 HttpResponse('Hello, World!') 跟 print('Hello, World') 很像，后者是我们学习 Python 语言时第一个演示程序。它俩都是输出 “Hello, World” 字符串，前者输出在浏览器上，后者输出在控制台（命令行）上。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

这就是框架的威力，我们只关注业务逻辑，底层的 http 如何请求、如何响应以及如何返回给浏览器都是框架帮我们做好了。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

3文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

连接数据库文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

一个电商网站会展现很多商品，这些商品信息都存储在数据库中。同样的，ncov应用也需要把疫情统计数据存储在数据库中。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

打开 “duma/settings.py” 文件，找到 DATABASES配置，如下文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'db.sqlite3',
}
}

这里有一些默认的配置。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

“default.ENGINE”代表数据库引擎是 sqlite3，是一个轻量数据库。你也可以将数据库引擎改成 MySQL、MongoDB等。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

“default.NAME”是数据库名称，对于sqlite数据库来说这里填数据库的路径， BASE_DIR 代表项目根目录，此时再看下项目根目录可以发现有 db.sqlite3文件，它是 Django 创建的，后面我们就用它来存储数据。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

不知道你会不会有这样的疑问，说好的数据库，怎么是个文件？实际上数据库的底层就是文件，只不过是在文件之上建立了一套引擎可以将文件中的内容以表格展示，并提供增加、删除、修改、查找的功能。就好比程序员的本质也是人，只不过从事编程工作所以被称为程序员。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

有了数据库，还需要在数据库里创建表。一般来说，可以用数据库命令直接建表。但由于我们用的是框架，所以就可以用 Django 来操作。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

在 “ncov/models.py” 文件中创建一个 Django 模型文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

from django.db import models


class CyStat(models.Model):
stat_dt = models.CharField(max_length=10) # 日期
cy_name = models.CharField(max_length=50) # 国家名称
confirm = models.integerField() # 累计确诊
dead = models.IntegerField() # 累计死亡
heal = models.IntegerField() # 累计治愈
today_confirm = models.IntegerField() # 现有确诊
today_new_confirm = models.IntegerField() # 新增确诊

这里定义 CyStat 类用来表示每个国家每天的疫情统计数据。包括 7 个属性，用 models 中的类对象来初始化。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

stat_dt 和 cy_name 定义为 models.CharField类型，代表字符类型。日期是 2021-11-01 这样的格式，占用10个字符，所以 max_length=10；对国家名称来说一般不超过 50 个字符，所以它的 max_length=50。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

其他几个字段都是统计数字，用整型即可。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

有了数据模型只是第一步，我们要怎么获取数据呢？这时候就需要将模型与数据库中的表关联起来。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

首先，将 ncov 应用注册到 duma 项目里，在 “duma/settings.py” 文件中找到 INSTALLED_APPS 配置，并在数组中添加 ncov 应用，添加后 INSTALLED_APPS 数组如下文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'ncov.apps.NcovConfig' # 注册 ncov 应用
]

接着，运行下面命令文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

python manage.py makemigrations ncov

执行后，可以看到输出以下信息文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

Migrations
for 'ncov':
  ncov/migrations/0001_initial.py
    - Create model CyStat

该命令会在 “ncov/migration” 目录下创建 0001_initial.py 文件，如果看源代码可能看不出它的功能，我们可以执行下面语句将其转成 sql 就容易理解了。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

python manage.py sqlmigrate ncov 0001

执行后，输出文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

BEGIN;
--
-- Create model CyStat
--
CREATE TABLE "ncov_cystat" ("id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, "stat_dt" varchar(10) NOT NULL, "cy_name" varchar(50) NOT NULL, "confirm" integer NOT NULL, "dead" integer NOT NULL, "heal" integer NOT NULL, "today_confirm" integer NOT NULL, "today_new_confirm" integer NOT NULL);
COMMIT;

可以发现实际上就是一条建表sql，表名是应用名和模型类名的组合，用下划线连接。除了 id 自动添加外，其他字段名称和定义与模型类属性一致。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

最后，执行下面命令来完成建表操作文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

python manage.py migrate

我们可以打开 db.sqlite3 数据库来查看是否成功。Mac电脑自带 sqlite3 命令直接打开，Windows 电脑可以安装 SQLite Administrator客户端。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

在项目根目录执行，打开数据库文件文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

sqlite3 db.sqlite3

执行 .tables 查看数据库中的表文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

sqlite> .tables
auth_group django_admin_log
auth_group_permissions django_content_type
auth_permission django_migrations
auth_user django_session
auth_user_groups ncov_cystat
auth_user_user_permissions

可以发现名为 ncov_cystat 的表，它就是按照 CyStat 类创建的表。除此之外还有很多其他表，它们是 Django 框架自带的，我们可以先忽略。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

这样我们将模型 CyStat 类与数据库中的 ncov_cystat 表对应的，后续我们需要查询或者修改数据直接操作 CyStat 类就可以了，而不用写 sql。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

这里我们又可以发现使用 Django 框架的一个优势 —— 将模型类与数据库隔离（行话叫解耦）。带来的好处是，如果未来我们的项目上线后想把 sqlite 数据库换成 MySQL，我们只需要在 settings.py 文件中修改 DATABASES 的数据库引擎和数据库名称，重新执行建表命令即可。表的定义以及对表的查询、更新逻辑完全不用改。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

4文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

编写web页面文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

最后一节，我们来编写web页面展现数据。有了上面的基础我们知道，应该在 views.py 文件中查询 ncov_cystat 表的数据，然后将数据返回给浏览器。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

首先需要向 ncov_cystat 表中导入一些数据，可以参考之前的文章《用Python绘制全球疫情变化地图》自己抓取。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

我也准备了一部分数据放在 “ncov/sql/插入疫情数据.sql” 源码包里，复制 1 ~ 60 行 sql 在 sqlite 客户端执行即可。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

sqlite> insert into ncov_cystat(stat_dt, cy_name, confirm, dead, heal, today_confirm, today_new_confirm) VALUES ("2021-09-03", "cn", 123169, 5685, 115024, 2460, 33);
sqlite> insert into ncov_cystat(stat_dt, cy_name, confirm, dead, heal, today_confirm, today_new_confirm) VALUES ("2021-09-04", "cn", 123199, 5685, 115105, 2409, 30);
...

读取数据，返回给浏览器。修改 “ncov/views.py” 文件中的 index 函数文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

from django.shortcuts import render

from .models import CyStat


def index(request):
cy_stats = CyStat.objects.filter(cy_name='cn').order_by('-stat_dt')[:7]
context = {
'cy_stats': cy_stats
}

return render(request, 'ncov/index.HTML', context)

CyStat.objects 会返回 ncov_cystat 表里所有记录，filter 用来按照字段过滤表中的数据，'cn'代表中国，cy_name='cn' 表示我们只保留国内数据，order_by 用来按照某字段（列）对返回的结果排序，字段名前加 ‘-’ 代表降序，这里我们只取最近 7 天的数据。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

现在我们不能像 “Hello, World” 那样直接返回，因为那种方式返回的是一个字符串，没有任何样式。我们返回的应该是一个 HTML 文件，所以需要调用 reder 函数，返回 “ncov/index.html”。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

在 ncov 目录里创建 “templates/ncov/index.html” 文件，编写以下代码文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

国内疫情数据



border="1">

{% for stat in cy_stats %}

{% endfor %}

日期	现有确诊	新增确诊
{{ stat.stat_dt }}	{{ stat.today_confirm }}	{{ stat.today_new_confirm }}

该文件中使用表格来展示数据，你会发现这并不是一个纯 HTML 文件。准确来说index.html 是Django 定义的一种模板语言，它支持按照一定的语法写 Python 代码，比如说里面的 for 循环、stat对象的使用。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

render 函数可以执行解析模板语言，生成纯 HTML 文件，返回给浏览器。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

在浏览器访问 http://127.0.0.1:8000/ncov/ ，可以看到如下页面文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

虽然数据能展示出来了，但有些丑，需要优化下前端样式。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

刚刚说的 HTML 和 Django 模板语言都是标记语言，语法都比较简单，之前没学过的朋友可以找些教程简单补一下。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

要展示比较漂亮的图片，一般要借助 js 实现，有 js 的基础的朋友可以自己写前端页面。如果没有可以用 pyecharts ，它支持用 Python 代码制作图表。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

下载 pyecharts GitHub 项目（https://github.com/pyecharts/pyecharts）源码，将 “pyecharts/render/templates” 目录中的源文件复制到 “ncov/templates” 目录中，结果如下文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

继续修改 index 函数，改为使用 pyecharts API 返回折线图。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

from django.http import HttpResponse
from django.shortcuts import render
from pyecharts.charts import Line, Map
from pyecharts import options as opts

from .models import CyStat


def index(request):
cy_stat = CyStat.objects.filter(cy_name='cn').order_by('-stat_dt')[:14]

stat_list = [x.stat_dt for x in cy_stat]
stat_list.reverse()

today_confirm_list = [x.today_confirm for x in cy_stat]
today_confirm_list.reverse()

today_new_confirm_list = [x.today_new_confirm for x in cy_stat]
today_new_confirm_list.reverse()

c = (
Line()
.add_xaxis(stat_list)
.add_yaxis("现有确诊", today_confirm_list)
.add_yaxis("新增确诊", today_new_confirm_list)
.set_global_opts(title_opts=opts.TitleOpts())
)
return HttpResponse(c.render_embed())

页面效果如下文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

这样的效果才像点样。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

学到这里，我们已经入门 Django 了。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/bc/26339.html

Django 入门练习教程：直接开干做个疫情可视化地图…牛逼牛逼！

国内疫情数据

从零开始认识 API，把网页信息化为己用

Python 开发者选择使用其他框架替代 Django，为什么？

Django Admin级联选择（Cascader）包django-smart-selects

Django菜鸟实例教程：路由分组和路由转发器

Django自定义manage.py shell命令及案例

Django admin后台默认模板文件解读

WordPress 6.5 新增块绑定 API 使用示例

WordPress 6.5 引入插件依赖关系，对开发者更友好！

Django项目开发中的6个实用小技巧

Laravel后端框架为什么这么优秀？

Comment