简介一份使用Python语言并结合Django框架、Bootstrap前端库与MySQL数据库开发的图书管理系统源码面向Web开发入门者、计算机专业学生以及需要完成课程设计或毕业设计的人群用于理解综合型网站后台的整体搭建流程。系统采用Django MTV设计模式内置出版社、作者、图书三类核心数据模型覆盖用户注册登录、权限控制、图书借阅归还等常用场景可对图书资料进行高效录入、查询、修改与删除且页面基于Bootstrap实现响应式布局。资源共包含63个文件以13个Python后端代码文件、11个HTML模板文件、7个CSS样式文件和4个JavaScript前端脚本为主同时附带10张界面功能截图、字体图标、地图文件、版本标识及说明文档压缩包整体仅1.33MB项目分层清晰便于按业务模块阅读使用。目前已有323人浏览学习适合作为从零到一实践Django Web开发的参考项目。通过源码可以掌握通过模型类定义数据表、编写视图函数处理请求、配置URL路由、利用Django内置ORM操作MySQL数据库以及借助Bootstrap快速美化界面等关键技能并可直接复用登录、列表、增删改查等完整交互逻辑为后续独立开发信息管理系统打下扎实基础。1. 图书管理系统先别急着写表把三个对象的关系定下来接到图书管理系统的需求先别急着写表。业务方丢来一句话「管管出版社、作者和图书」。把三个对象摆在一起关系问题就藏不住了一个出版社出版多本图书一本图书又挂多个作者。这套 Python Django Bootstrap MySQL 的搭配正是处理这类关系型业务最常见的组合Django 管业务逻辑MySQL 负责落盘Bootstrap 把数据变成像样的页面。这套系统看着是标准增删改查真正花时间的从来不是页面而是模型关系和数据库配置。做完它等于把 Django 项目的完整链路走了一遍模型设计、迁移、Admin 验证、视图路由、表单校验、搜索分页、切 MySQL、备份。刚学完 Django 想练手或者要在公司内部交付一个小工具都能按这套方案抄作业。2. 模型层先行出版社、作者、图书三个模型的字段与关联设计2.1 一对多与多对多外键和中间表落在哪一侧先想清楚关系再写代码。出版社和图书之间是一对多一个出版社出版多本图书反过来一本书只属于一个出版社。这是最标准的外键场景外键字段放在「多」的那一侧也就是 Book 模型里放 publisher 字段。如果把外键放在 Publisher 里一本图书只能对应一个出版社但一个出版社要存多本书就得存一个列表字段查询和统计都会变得很难受。作者和图书之间是多对多一本书可以有几个作者一个作者也可以写多本书。Django 的 ManyToManyField 会自动生成一张中间表不需要手动建关联模型。常见的错误是图省事在 Book 里加一个 author_names 的 CharField把多个名字拼成一个字符串存进去。后面想按作者筛选、统计作品数量全得靠字符串切割数据一旦多起来就是给自己埋雷。所以这个项目建模的核心就两条规则一对多放外键多对多用 ManyToManyField。字段类型选对后面查数据、做页面、接表单都会顺很多。我一般还会给外键和反查起好 related_name比如出版社反查图书用 books这样模板和查询里读起来像读句子而不是像翻字典。2.2 模型定义与迁移字段参数与约束的取舍下面是把三个模型落在代码里的完整写法也是这套系统的地基# books/models.py from django.db import models class Publisher(models.Model): name models.CharField(出版社名称, max_length64) address models.CharField(地址, max_length128, blankTrue) class Meta: verbose_name 出版社 verbose_name_plural verbose_name ordering [name] def __str__(self): return self.name class Author(models.Model): name models.CharField(作者姓名, max_length32) email models.EmailField(邮箱, blankTrue) class Meta: verbose_name 作者 verbose_name_plural verbose_name ordering [name] def __str__(self): return self.name class Book(models.Model): title models.CharField(书名, max_length128) publisher models.ForeignKey( Publisher, on_deletemodels.PROTECT, related_namebooks, verbose_name出版社, ) authors models.ManyToManyField( Author, related_namebooks, verbose_name作者, ) pub_date models.DateField(出版日期) price models.DecimalField(定价, max_digits6, decimal_places2) class Meta: verbose_name 图书 verbose_name_plural verbose_name ordering [-pub_date] def __str__(self): return self.title几个参数值得单独说。CharField 的 max_length 在 MySQL 里直接对应 varchar 的长度书名 128、出版社 64给足余量比以后频繁迁移划算。出版日期用 DateField 而不是 DateTimeField因为业务上只需要年月日DateTimeField 会带时间选择器反而容易误操作。price 用 DecimalField 而不是 FloatField价格是精确值Float 有浮点误差账会对不上max_digits6 表示总位数最多 6 位decimal_places2 表示两位小数也就是最大能存 9999.99。on_delete 我选了 PROTECT理由是出版社下面如果还挂着图书就禁止删除出版社避免误操作连带把书删光。这个选择在第 5 章会展开对比。ManyToManyField 会自动生成一张 book_authors 中间表你不需要手动建查询一本书的作者用 book.authors.all()查一个作者的书用 author.books.all()也就是上面 related_name 的作用。模型写好后执行迁移python manage.py makemigrations books python manage.py migratemakemigrations 会根据模型变化生成迁移文件migrate 把迁移落到数据库。想确认生成 SQL 是否符合预期可以执行python manage.py sqlmigrate books 0001能看到建表语句和外键约束这一步在切 MySQL 之后尤其值得做一次。2.3 用 Admin 做冒烟验证不写页面先验证数据关系模型定完先别急着写页面。Django Admin 是现成的数据管理后台注册进去就能操作数据先在这验证模型关系比直接写页面高效得多# books/admin.py from django.contrib import admin from .models import Publisher, Author, Book admin.register(Publisher) class PublisherAdmin(admin.ModelAdmin): list_display (name, address) admin.register(Author) class AuthorAdmin(admin.ModelAdmin): list_display (name, email) admin.register(Book) class BookAdmin(admin.ModelAdmin): list_display (title, publisher, pub_date, price) list_filter (publisher, pub_date) filter_horizontal (authors,)然后创建超级用户并启动服务python manage.py createsuperuser python manage.py runserver访问/admin/往里录几个出版社、几个作者、几本图书。filter_horizontal 会把作者字段渲染成左右两栏的选择框多对多关系一目了然。这个阶段把数据关系验透后面写页面时 90% 的字段问题已经提前暴露了。3. 视图、路由与 Bootstrap 页面把模型变成可操作的界面3.1 URL 设计与视图函数列表、新增、编辑、删除的完整映射模型验证通过后进入页面环节。路由我用 app_name 加命名空间方便模板里用{% url books:list %}反转地址不用到处硬编码 URL# config/urls.py from django.contrib import admin from django.urls import path, include urlpatterns [ path(admin/, admin.site.urls), path(books/, include(books.urls)), ]# books/urls.py from django.urls import path from . import views app_name books urlpatterns [ path(, views.book_list, namelist), path(create/, views.book_create, namecreate), path(int:pk/edit/, views.book_edit, nameedit), path(int:pk/delete/, views.book_delete, namedelete), ]视图函数我习惯用 FBV这个体量的系统 FBV 足够清晰新手也容易看懂每一步在干什么。核心是四个函数# books/views.py from django.shortcuts import render, get_object_or_404, redirect from django.core.paginator import Paginator from .models import Book from .forms import BookForm def book_list(request): # select_related 解决外键查询prefetch_related 解决多对多查询 books Book.objects.select_related(publisher).prefetch_related(authors) q request.GET.get(q, ).strip() if q: books books.filter(title__icontainsq) paginator Paginator(books, 10) # 每页 10 条 page paginator.get_page(request.GET.get(page)) return render(request, books/list.html, {page: page, q: q}) def book_create(request): form BookForm(request.POST or None) if request.method POST and form.is_valid(): form.save() return redirect(books:list) return render(request, books/form.html, {form: form}) def book_edit(request, pk): book get_object_or_404(Book, pkpk) form BookForm(request.POST or None, instancebook) if request.method POST and form.is_valid(): form.save() return redirect(books:list) return render(request, books/form.html, {form: form}) def book_delete(request, pk): book get_object_or_404(Book, pkpk) if request.method POST: book.delete() return redirect(books:list) return render(request, books/confirm_delete.html, {book: book})request.POST or None是个常见写法POST 请求时用提交的数据初始化表单否则给空表单。编辑时多传一个 instancebook表单会带着已有数据。列表页的 select_related 和 prefetch_related 是查 N1 问题的关键循环里访问 book.publisher 和 book.authors.all() 时如果没有预取每行数据会额外发好几条 SQL图书一多页面明显变慢。删除操作我特意放在 POST 请求里模板里用表单提交而不是一个 GET 链接。否则搜索引擎爬虫或者浏览器预取可能直接把数据删掉这是个血泪经验。3.2 Bootstrap 集成CDN 与本地静态文件怎么选页面风格直接交给 Bootstrap。两种引入方式用 CDN 链接或者把文件下载到项目本地。公司内部工具经常跑在不能访问外网的机器上所以我倾向于第二种。把 bootstrap.min.css 和 bootstrap.bundle.min.js 放进 books/static/vendor/bootstrap/ 目录然后做一个基础模板所有页面继承它!-- books/templates/base.html -- {% load static %} !DOCTYPE html html langzh-cn head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title{% block title %}图书管理系统{% endblock %}/title link relstylesheet href{% static vendor/bootstrap/bootstrap.min.css %} /head body {% block content %}{% endblock %} script src{% static vendor/bootstrap/bootstrap.bundle.min.js %}/script /body /html{% load static %}必须写在模板最上面{% static ... %}会根据 settings 里的 STATIC_URL 拼出实际地址。django.contrib.staticfiles 默认在 INSTALLED_APPS 里开发时 runserver 会自动找到每个 app 的 static 目录。3.3 图书列表页与表单页表格、搜索、分页、校验一次配齐列表页是这套系统的门面搜索框、表格、空状态、分页全放一起!-- books/templates/books/list.html -- {% extends base.html %} {% block content %} div classcontainer py-4 div classd-flex justify-content-between align-items-center mb-3 h1图书列表/h1 a href{% url books:create %} classbtn btn-primary新增图书/a /div form methodget classrow g-2 mb-3 div classcol-auto input typetext nameq value{{ q }} classform-control placeholder按书名搜索 /div div classcol-auto button typesubmit classbtn btn-outline-secondary搜索/button /div /form table classtable table-striped align-middle thead tr th书名/thth出版社/thth作者/th th出版日期/thth定价/thth操作/th /tr /thead tbody {% for book in page %} tr td{{ book.title }}/td td{{ book.publisher.name }}/td td {% for author in book.authors.all %} {{ author.name }}{% if not forloop.last %}、{% endif %} {% endfor %} /td td{{ book.pub_date|date:Y-m-d }}/td td{{ book.price }}/td td a href{% url books:edit book.pk %} classbtn btn-sm btn-outline-primary编辑/a a href{% url books:delete book.pk %} classbtn btn-sm btn-outline-danger删除/a /td /tr {% empty %} tr td colspan6 classtext-center text-muted没有找到图书/td /tr {% endfor %} /tbody /table {% include partials/_pagination.html %} /div {% endblock %}{% empty %}是模板循环的空状态分支数据为空时不用写一堆 if 判断。作者字段是多对多循环渲染时用forloop.last判断是不是最后一个用来拼顿号。新增和编辑共用一个表单模板这是 Django ModelForm 的典型优势。表单的字段渲染、错误提示都在一个文件里维护# books/forms.py from django import forms from .models import Book class BookForm(forms.ModelForm): class Meta: model Book fields [title, publisher, authors, pub_date, price] widgets { pub_date: forms.DateInput(attrs{type: date}), } def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) # 统一给所有字段加上 Bootstrap 的 form-control 样式 for field in self.fields.values(): field.widget.attrs.setdefault(class, form-control)!-- books/templates/books/form.html -- {% extends base.html %} {% block content %} div classcontainer py-4 stylemax-width: 620px; h1 classmb-3{{ form.instance.pk|yesno:编辑图书,新增图书 }}/h1 form methodpost novalidate {% csrf_token %} {% for field in form %} div classmb-3 label classform-label for{{ field.id_for_label }}{{ field.label }}/label {{ field }} {% if field.errors %} div classtext-danger small{{ field.errors.0 }}/div {% endif %} /div {% endfor %} button typesubmit classbtn btn-primary保存/button a href{% url books:list %} classbtn btn-secondary返回/a /form /div {% endblock %}表单提交时加上novalidate不让浏览器原生校验先拦截交给 Django 的服务端校验统一处理错误提示才能以统一样式显示在字段下方。form.instance.pk|yesno是一个小技巧同一份模板根据有没有主键自动切换标题是「新增图书」还是「编辑图书」。4. 切到 MySQL驱动配置、建库编码与备份4.1 驱动选择与 settings.py 里的关键参数开发时很多人用 SQLite 起步但交付部署时 MySQL 是更稳的选择并发写入、权限控制、备份恢复都更成熟。切换的第一步是装驱动。Windows 上装 mysqlclient 经常遇到编译问题我一般用 pymysql兼容性好安装没有门槛pip install pymysql然后在项目配置目录的__init__.py里加上一行# config/__init__.py import pymysql pymysql.install_as_MySQLdb()这行的作用是让 Django 的 MySQL 后端复用 pymysql 的实现装作是 MySQLdb省去一堆兼容性配置。接着改 settings.py# config/settings.py DATABASES { default: { ENGINE: django.db.backends.mysql, NAME: book_system, USER: book_user, PASSWORD: 你的密码, HOST: 127.0.0.1, PORT: 3306, CONN_MAX_AGE: 60, OPTIONS: { charset: utf8mb4, }, } }参数作用建议值ENGINE指定数据库后端django.db.backends.mysqlNAME数据库名book_systemUSER / PASSWORD连接账号单独建业务账号别用 rootHOST / PORT数据库地址与端口127.0.0.1:3306CONN_MAX_AGE连接复用时间秒60减少重复握手开销OPTIONS.charset客户端字符集utf8mb4CONN_MAX_AGE 的意思是连接建立后最多复用 60 秒60 秒内的请求不重新握手。这个值不要设太大MySQL 服务端有 wait_timeout超时后连接其实已经断了复用反而报错。4.2 建库语句与 utf8mb4中文数据不乱码的前提Django 只负责建表数据库本身要手动建。建库时指定字符集这是中文数据不乱码的根CREATE DATABASE book_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;utf8mb4 和老的 utf8 的区别在于utf8mb4 是完整四字节 UTF-8能存 emoji 和生僻字utf8 在 MySQL 里其实是残缺的三字节实现遇到特殊字符直接报错。排序规则用 utf8mb4_unicode_ci对中文和英文排序都比较正常。MySQL 8.0 默认就是 utf8mb4但建库时显式写出来以后换机器、换版本不会踩坑。建完库执行迁移python manage.py migrate python manage.py createsuperuser注意切换数据库不会把原 SQLite 里的数据带过来。想保留数据用python manage.py dumpdata导出、python manage.py loaddata导入或者干脆在 Admin 里重新录一遍。图书管理系统这种体量我一般直接重录测试数据。4.3 mysqldump 备份与恢复最小操作集数据库上线后第一件事是确认备份能跑通。mysqldump 是 MySQL 自带的工具不需要额外安装mysqldump -u book_user -p --single-transaction --default-character-setutf8mb4 book_system | gzip book_system_$(date %Y%m%d).sql.gz--single-transaction对 InnoDB 表做一致性备份备份过程中业务还能继续写数据--default-character-setutf8mb4保证导出文件里中文不乱码。恢复时先解压再导回gunzip -c book_system_20250101.sql.gz | mysql -u book_user -p book_system恢复前建议先确认目标库是空的或者你已经知道会覆盖什么。我见过有人把备份恢复到线上库结果老数据和新备份混在一起比不备份还难收拾。5. 避坑指南图书管理系统最常见的 5 个翻车现场5.1 静态文件 404关掉 DEBUG 后样式全丢现象runserver 下页面一切正常部署或把 DEBUG 改成 False 之后HTML 还在但 CSS、JS 全部 404页面跟裸奔一样。原因Django 开发服务器只有在 DEBUGTrue 时才会自动托管静态文件。关掉 DEBUG静态文件服务就交给了部署层Nginx 或其他 Web 服务器而且项目的 STATIC_ROOT 目录根本没生成。解决部署前跑一下 collectstatic把各 app 的静态文件收集到 STATIC_ROOT 指定目录开发期想临时看效果用 runserver 的 --insecure 参数python manage.py collectstatic --noinput python manage.py runserver --insecure5.2 migrate 报外键错误迁移顺序和依赖没理清现象执行 migrate 时提示ValueError: Related model ... cannot be resolved或者建表报错说外键指向的表不存在。原因多 app 项目里Book 的外键指向了另一个 app 的 Publisher但被依赖的 app 迁移还没执行。虽然本项目三个模型都在同一个 app 里顺序问题少但一旦拆成多 app这个问题迟早遇到。解决先迁移被依赖的 app。可以用 showmigrations 看当前迁移状态python manage.py showmigrations books python manage.py migrate publishers python manage.py migrate books千万别手改 migrations 文件迁移文件跟数据库里的迁移记录是一一对应的手改等于制造不一致。如果表结构被外部工具改过可以用 --fake 标记已应用但这是后悔药只在确认迁移和实际表结构完全一致时用否则不要碰。5.3 出版日期保存后不变auto_now_add 的玄学现象给 pub_date 加了 auto_now_addTrue新增时日期自动填了当前时间但编辑时表单里根本没有这个字段保存后日期也不变。原因auto_now_add 只在记录创建的那一刻写入当前时间之后永远不会变化表单也不会渲染它。它是给 created_at 这类审计字段设计的不是给业务日期设计的。解决出版日期是业务数据应该用普通 DateField让用户在表单里手动选择。auto_now_add 留给「创建时间」如果还需要「最后修改时间」用 auto_nowTrue它会在每次 save 时更新。5.4 删除出版社把书删光了on_delete 行为差异现象在 Admin 里删一个出版社要么提示 ProtectedError 删不掉要么出版社没了它下面所有的图书也没了。原因外键的 on_delete 参数决定了删除关联对象时的行为CASCADE 会把图书连带删光PROTECT 会阻止删除并抛异常这俩语义完全不同选错代价很大。解决按业务重要性选。图书数据通常比出版社信息金贵我用 PROTECT删不掉就说明下面有书先处理图书再删出版社。如果业务允许书在出版社删除后保留外键加 nullTrue、blankTrue用 SET_NULL图书保留但出版社变成空。三种行为对比如下on_delete 选项删除出版社时的行为适用场景CASCADE连带删除所有图书图书没有保留价值PROTECT抛 ProtectedError禁止删除图书数据重要SET_NULL图书保留外键置为 NULL允许图书无出版社5.5 搜索后翻页搜索条件丢了现象按书名搜索「Django」结果有两页点第 2 页页面变成全部图书的第 2 页搜索条件没了。原因分页链接只拼了 page 参数没有带上 q。模板里如果写href?page{{ page.next_page_number }}翻页必然丢失搜索条件。解决分页链接里把 q 一起拼回去注意用 urlencode 过滤特殊字符a classpage-link href?page{{ page.next_page_number }}{% if q %}q{{ q|urlencode }}{% endif %} 下一页 /a这个坑在后面第 6 章做分页组件时我会直接内置进去避免每个列表页各踩一遍。6. 把分页和搜索条件打包成一个模板组件include 与模板继承的最后一块拼图图书列表、作者列表、出版社列表三个页面都需要分页而且都要保留搜索参数。与其在每个模板里复制粘贴那一堆上一页下一页的判断不如拆成一个公共组件。在 templates/partials/ 下新建 _pagination.html!-- books/templates/partials/_pagination.html -- {% if page.has_other_pages %} nav aria-label列表分页 ul classpagination justify-content-center {% if page.has_previous %} li classpage-item a classpage-link href?page{{ page.previous_page_number }}{% if q %}q{{ q|urlencode }}{% endif %} 上一页 /a /li {% endif %} li classpage-item disabled span classpage-link{{ page.number }} / {{ page.paginator.num_pages }}/span /li {% if page.has_next %} li classpage-item a classpage-link href?page{{ page.next_page_number }}{% if q %}q{{ q|urlencode }}{% endif %} 下一页 /a /li {% endif %} /ul /nav {% endif %}在列表页底部一行引入{% include partials/_pagination.html %}include 默认继承当前模板的上下文只要视图里传了 page 和 q组件里直接用就行。如果某个页面的变量名不一样也可以用{% include partials/_pagination.html with pagepaginator_obj qkeyword %}显式传参。这就是这个组件的全部价值把第 5 章说过的搜索参数保留问题在组件层面解决掉而不是靠每个开发者记得拼参数。我交付前会再做两件事一是在空数据库里跑一遍列表页和表单页确认空状态、必填校验都正常二是造一条超长书名、一个挂了十几位作者的图书看看表格布局会不会被撑坏。这两个场景比正常数据更容易暴露翻车问题做多了就成了习惯。希望帮到你。本文还有配套的精品资源点击获取
简介一份使用Python语言并结合Django框架、Bootstrap前端库与MySQL数据库开发的图书管理系统源码面向Web开发入门者、计算机专业学生以及需要完成课程设计或毕业设计的人群用于理解综合型网站后台的整体搭建流程。系统采用Django MTV设计模式内置出版社、作者、图书三类核心数据模型覆盖用户注册登录、权限控制、图书借阅归还等常用场景可对图书资料进行高效录入、查询、修改与删除且页面基于Bootstrap实现响应式布局。资源共包含63个文件以13个Python后端代码文件、11个HTML模板文件、7个CSS样式文件和4个JavaScript前端脚本为主同时附带10张界面功能截图、字体图标、地图文件、版本标识及说明文档压缩包整体仅1.33MB项目分层清晰便于按业务模块阅读使用。目前已有323人浏览学习适合作为从零到一实践Django Web开发的参考项目。通过源码可以掌握通过模型类定义数据表、编写视图函数处理请求、配置URL路由、利用Django内置ORM操作MySQL数据库以及借助Bootstrap快速美化界面等关键技能并可直接复用登录、列表、增删改查等完整交互逻辑为后续独立开发信息管理系统打下扎实基础。1. 图书管理系统先别急着写表把三个对象的关系定下来接到图书管理系统的需求先别急着写表。业务方丢来一句话「管管出版社、作者和图书」。把三个对象摆在一起关系问题就藏不住了一个出版社出版多本图书一本图书又挂多个作者。这套 Python Django Bootstrap MySQL 的搭配正是处理这类关系型业务最常见的组合Django 管业务逻辑MySQL 负责落盘Bootstrap 把数据变成像样的页面。这套系统看着是标准增删改查真正花时间的从来不是页面而是模型关系和数据库配置。做完它等于把 Django 项目的完整链路走了一遍模型设计、迁移、Admin 验证、视图路由、表单校验、搜索分页、切 MySQL、备份。刚学完 Django 想练手或者要在公司内部交付一个小工具都能按这套方案抄作业。2. 模型层先行出版社、作者、图书三个模型的字段与关联设计2.1 一对多与多对多外键和中间表落在哪一侧先想清楚关系再写代码。出版社和图书之间是一对多一个出版社出版多本图书反过来一本书只属于一个出版社。这是最标准的外键场景外键字段放在「多」的那一侧也就是 Book 模型里放 publisher 字段。如果把外键放在 Publisher 里一本图书只能对应一个出版社但一个出版社要存多本书就得存一个列表字段查询和统计都会变得很难受。作者和图书之间是多对多一本书可以有几个作者一个作者也可以写多本书。Django 的 ManyToManyField 会自动生成一张中间表不需要手动建关联模型。常见的错误是图省事在 Book 里加一个 author_names 的 CharField把多个名字拼成一个字符串存进去。后面想按作者筛选、统计作品数量全得靠字符串切割数据一旦多起来就是给自己埋雷。所以这个项目建模的核心就两条规则一对多放外键多对多用 ManyToManyField。字段类型选对后面查数据、做页面、接表单都会顺很多。我一般还会给外键和反查起好 related_name比如出版社反查图书用 books这样模板和查询里读起来像读句子而不是像翻字典。2.2 模型定义与迁移字段参数与约束的取舍下面是把三个模型落在代码里的完整写法也是这套系统的地基# books/models.py from django.db import models class Publisher(models.Model): name models.CharField(出版社名称, max_length64) address models.CharField(地址, max_length128, blankTrue) class Meta: verbose_name 出版社 verbose_name_plural verbose_name ordering [name] def __str__(self): return self.name class Author(models.Model): name models.CharField(作者姓名, max_length32) email models.EmailField(邮箱, blankTrue) class Meta: verbose_name 作者 verbose_name_plural verbose_name ordering [name] def __str__(self): return self.name class Book(models.Model): title models.CharField(书名, max_length128) publisher models.ForeignKey( Publisher, on_deletemodels.PROTECT, related_namebooks, verbose_name出版社, ) authors models.ManyToManyField( Author, related_namebooks, verbose_name作者, ) pub_date models.DateField(出版日期) price models.DecimalField(定价, max_digits6, decimal_places2) class Meta: verbose_name 图书 verbose_name_plural verbose_name ordering [-pub_date] def __str__(self): return self.title几个参数值得单独说。CharField 的 max_length 在 MySQL 里直接对应 varchar 的长度书名 128、出版社 64给足余量比以后频繁迁移划算。出版日期用 DateField 而不是 DateTimeField因为业务上只需要年月日DateTimeField 会带时间选择器反而容易误操作。price 用 DecimalField 而不是 FloatField价格是精确值Float 有浮点误差账会对不上max_digits6 表示总位数最多 6 位decimal_places2 表示两位小数也就是最大能存 9999.99。on_delete 我选了 PROTECT理由是出版社下面如果还挂着图书就禁止删除出版社避免误操作连带把书删光。这个选择在第 5 章会展开对比。ManyToManyField 会自动生成一张 book_authors 中间表你不需要手动建查询一本书的作者用 book.authors.all()查一个作者的书用 author.books.all()也就是上面 related_name 的作用。模型写好后执行迁移python manage.py makemigrations books python manage.py migratemakemigrations 会根据模型变化生成迁移文件migrate 把迁移落到数据库。想确认生成 SQL 是否符合预期可以执行python manage.py sqlmigrate books 0001能看到建表语句和外键约束这一步在切 MySQL 之后尤其值得做一次。2.3 用 Admin 做冒烟验证不写页面先验证数据关系模型定完先别急着写页面。Django Admin 是现成的数据管理后台注册进去就能操作数据先在这验证模型关系比直接写页面高效得多# books/admin.py from django.contrib import admin from .models import Publisher, Author, Book admin.register(Publisher) class PublisherAdmin(admin.ModelAdmin): list_display (name, address) admin.register(Author) class AuthorAdmin(admin.ModelAdmin): list_display (name, email) admin.register(Book) class BookAdmin(admin.ModelAdmin): list_display (title, publisher, pub_date, price) list_filter (publisher, pub_date) filter_horizontal (authors,)然后创建超级用户并启动服务python manage.py createsuperuser python manage.py runserver访问/admin/往里录几个出版社、几个作者、几本图书。filter_horizontal 会把作者字段渲染成左右两栏的选择框多对多关系一目了然。这个阶段把数据关系验透后面写页面时 90% 的字段问题已经提前暴露了。3. 视图、路由与 Bootstrap 页面把模型变成可操作的界面3.1 URL 设计与视图函数列表、新增、编辑、删除的完整映射模型验证通过后进入页面环节。路由我用 app_name 加命名空间方便模板里用{% url books:list %}反转地址不用到处硬编码 URL# config/urls.py from django.contrib import admin from django.urls import path, include urlpatterns [ path(admin/, admin.site.urls), path(books/, include(books.urls)), ]# books/urls.py from django.urls import path from . import views app_name books urlpatterns [ path(, views.book_list, namelist), path(create/, views.book_create, namecreate), path(int:pk/edit/, views.book_edit, nameedit), path(int:pk/delete/, views.book_delete, namedelete), ]视图函数我习惯用 FBV这个体量的系统 FBV 足够清晰新手也容易看懂每一步在干什么。核心是四个函数# books/views.py from django.shortcuts import render, get_object_or_404, redirect from django.core.paginator import Paginator from .models import Book from .forms import BookForm def book_list(request): # select_related 解决外键查询prefetch_related 解决多对多查询 books Book.objects.select_related(publisher).prefetch_related(authors) q request.GET.get(q, ).strip() if q: books books.filter(title__icontainsq) paginator Paginator(books, 10) # 每页 10 条 page paginator.get_page(request.GET.get(page)) return render(request, books/list.html, {page: page, q: q}) def book_create(request): form BookForm(request.POST or None) if request.method POST and form.is_valid(): form.save() return redirect(books:list) return render(request, books/form.html, {form: form}) def book_edit(request, pk): book get_object_or_404(Book, pkpk) form BookForm(request.POST or None, instancebook) if request.method POST and form.is_valid(): form.save() return redirect(books:list) return render(request, books/form.html, {form: form}) def book_delete(request, pk): book get_object_or_404(Book, pkpk) if request.method POST: book.delete() return redirect(books:list) return render(request, books/confirm_delete.html, {book: book})request.POST or None是个常见写法POST 请求时用提交的数据初始化表单否则给空表单。编辑时多传一个 instancebook表单会带着已有数据。列表页的 select_related 和 prefetch_related 是查 N1 问题的关键循环里访问 book.publisher 和 book.authors.all() 时如果没有预取每行数据会额外发好几条 SQL图书一多页面明显变慢。删除操作我特意放在 POST 请求里模板里用表单提交而不是一个 GET 链接。否则搜索引擎爬虫或者浏览器预取可能直接把数据删掉这是个血泪经验。3.2 Bootstrap 集成CDN 与本地静态文件怎么选页面风格直接交给 Bootstrap。两种引入方式用 CDN 链接或者把文件下载到项目本地。公司内部工具经常跑在不能访问外网的机器上所以我倾向于第二种。把 bootstrap.min.css 和 bootstrap.bundle.min.js 放进 books/static/vendor/bootstrap/ 目录然后做一个基础模板所有页面继承它!-- books/templates/base.html -- {% load static %} !DOCTYPE html html langzh-cn head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title{% block title %}图书管理系统{% endblock %}/title link relstylesheet href{% static vendor/bootstrap/bootstrap.min.css %} /head body {% block content %}{% endblock %} script src{% static vendor/bootstrap/bootstrap.bundle.min.js %}/script /body /html{% load static %}必须写在模板最上面{% static ... %}会根据 settings 里的 STATIC_URL 拼出实际地址。django.contrib.staticfiles 默认在 INSTALLED_APPS 里开发时 runserver 会自动找到每个 app 的 static 目录。3.3 图书列表页与表单页表格、搜索、分页、校验一次配齐列表页是这套系统的门面搜索框、表格、空状态、分页全放一起!-- books/templates/books/list.html -- {% extends base.html %} {% block content %} div classcontainer py-4 div classd-flex justify-content-between align-items-center mb-3 h1图书列表/h1 a href{% url books:create %} classbtn btn-primary新增图书/a /div form methodget classrow g-2 mb-3 div classcol-auto input typetext nameq value{{ q }} classform-control placeholder按书名搜索 /div div classcol-auto button typesubmit classbtn btn-outline-secondary搜索/button /div /form table classtable table-striped align-middle thead tr th书名/thth出版社/thth作者/th th出版日期/thth定价/thth操作/th /tr /thead tbody {% for book in page %} tr td{{ book.title }}/td td{{ book.publisher.name }}/td td {% for author in book.authors.all %} {{ author.name }}{% if not forloop.last %}、{% endif %} {% endfor %} /td td{{ book.pub_date|date:Y-m-d }}/td td{{ book.price }}/td td a href{% url books:edit book.pk %} classbtn btn-sm btn-outline-primary编辑/a a href{% url books:delete book.pk %} classbtn btn-sm btn-outline-danger删除/a /td /tr {% empty %} tr td colspan6 classtext-center text-muted没有找到图书/td /tr {% endfor %} /tbody /table {% include partials/_pagination.html %} /div {% endblock %}{% empty %}是模板循环的空状态分支数据为空时不用写一堆 if 判断。作者字段是多对多循环渲染时用forloop.last判断是不是最后一个用来拼顿号。新增和编辑共用一个表单模板这是 Django ModelForm 的典型优势。表单的字段渲染、错误提示都在一个文件里维护# books/forms.py from django import forms from .models import Book class BookForm(forms.ModelForm): class Meta: model Book fields [title, publisher, authors, pub_date, price] widgets { pub_date: forms.DateInput(attrs{type: date}), } def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) # 统一给所有字段加上 Bootstrap 的 form-control 样式 for field in self.fields.values(): field.widget.attrs.setdefault(class, form-control)!-- books/templates/books/form.html -- {% extends base.html %} {% block content %} div classcontainer py-4 stylemax-width: 620px; h1 classmb-3{{ form.instance.pk|yesno:编辑图书,新增图书 }}/h1 form methodpost novalidate {% csrf_token %} {% for field in form %} div classmb-3 label classform-label for{{ field.id_for_label }}{{ field.label }}/label {{ field }} {% if field.errors %} div classtext-danger small{{ field.errors.0 }}/div {% endif %} /div {% endfor %} button typesubmit classbtn btn-primary保存/button a href{% url books:list %} classbtn btn-secondary返回/a /form /div {% endblock %}表单提交时加上novalidate不让浏览器原生校验先拦截交给 Django 的服务端校验统一处理错误提示才能以统一样式显示在字段下方。form.instance.pk|yesno是一个小技巧同一份模板根据有没有主键自动切换标题是「新增图书」还是「编辑图书」。4. 切到 MySQL驱动配置、建库编码与备份4.1 驱动选择与 settings.py 里的关键参数开发时很多人用 SQLite 起步但交付部署时 MySQL 是更稳的选择并发写入、权限控制、备份恢复都更成熟。切换的第一步是装驱动。Windows 上装 mysqlclient 经常遇到编译问题我一般用 pymysql兼容性好安装没有门槛pip install pymysql然后在项目配置目录的__init__.py里加上一行# config/__init__.py import pymysql pymysql.install_as_MySQLdb()这行的作用是让 Django 的 MySQL 后端复用 pymysql 的实现装作是 MySQLdb省去一堆兼容性配置。接着改 settings.py# config/settings.py DATABASES { default: { ENGINE: django.db.backends.mysql, NAME: book_system, USER: book_user, PASSWORD: 你的密码, HOST: 127.0.0.1, PORT: 3306, CONN_MAX_AGE: 60, OPTIONS: { charset: utf8mb4, }, } }参数作用建议值ENGINE指定数据库后端django.db.backends.mysqlNAME数据库名book_systemUSER / PASSWORD连接账号单独建业务账号别用 rootHOST / PORT数据库地址与端口127.0.0.1:3306CONN_MAX_AGE连接复用时间秒60减少重复握手开销OPTIONS.charset客户端字符集utf8mb4CONN_MAX_AGE 的意思是连接建立后最多复用 60 秒60 秒内的请求不重新握手。这个值不要设太大MySQL 服务端有 wait_timeout超时后连接其实已经断了复用反而报错。4.2 建库语句与 utf8mb4中文数据不乱码的前提Django 只负责建表数据库本身要手动建。建库时指定字符集这是中文数据不乱码的根CREATE DATABASE book_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;utf8mb4 和老的 utf8 的区别在于utf8mb4 是完整四字节 UTF-8能存 emoji 和生僻字utf8 在 MySQL 里其实是残缺的三字节实现遇到特殊字符直接报错。排序规则用 utf8mb4_unicode_ci对中文和英文排序都比较正常。MySQL 8.0 默认就是 utf8mb4但建库时显式写出来以后换机器、换版本不会踩坑。建完库执行迁移python manage.py migrate python manage.py createsuperuser注意切换数据库不会把原 SQLite 里的数据带过来。想保留数据用python manage.py dumpdata导出、python manage.py loaddata导入或者干脆在 Admin 里重新录一遍。图书管理系统这种体量我一般直接重录测试数据。4.3 mysqldump 备份与恢复最小操作集数据库上线后第一件事是确认备份能跑通。mysqldump 是 MySQL 自带的工具不需要额外安装mysqldump -u book_user -p --single-transaction --default-character-setutf8mb4 book_system | gzip book_system_$(date %Y%m%d).sql.gz--single-transaction对 InnoDB 表做一致性备份备份过程中业务还能继续写数据--default-character-setutf8mb4保证导出文件里中文不乱码。恢复时先解压再导回gunzip -c book_system_20250101.sql.gz | mysql -u book_user -p book_system恢复前建议先确认目标库是空的或者你已经知道会覆盖什么。我见过有人把备份恢复到线上库结果老数据和新备份混在一起比不备份还难收拾。5. 避坑指南图书管理系统最常见的 5 个翻车现场5.1 静态文件 404关掉 DEBUG 后样式全丢现象runserver 下页面一切正常部署或把 DEBUG 改成 False 之后HTML 还在但 CSS、JS 全部 404页面跟裸奔一样。原因Django 开发服务器只有在 DEBUGTrue 时才会自动托管静态文件。关掉 DEBUG静态文件服务就交给了部署层Nginx 或其他 Web 服务器而且项目的 STATIC_ROOT 目录根本没生成。解决部署前跑一下 collectstatic把各 app 的静态文件收集到 STATIC_ROOT 指定目录开发期想临时看效果用 runserver 的 --insecure 参数python manage.py collectstatic --noinput python manage.py runserver --insecure5.2 migrate 报外键错误迁移顺序和依赖没理清现象执行 migrate 时提示ValueError: Related model ... cannot be resolved或者建表报错说外键指向的表不存在。原因多 app 项目里Book 的外键指向了另一个 app 的 Publisher但被依赖的 app 迁移还没执行。虽然本项目三个模型都在同一个 app 里顺序问题少但一旦拆成多 app这个问题迟早遇到。解决先迁移被依赖的 app。可以用 showmigrations 看当前迁移状态python manage.py showmigrations books python manage.py migrate publishers python manage.py migrate books千万别手改 migrations 文件迁移文件跟数据库里的迁移记录是一一对应的手改等于制造不一致。如果表结构被外部工具改过可以用 --fake 标记已应用但这是后悔药只在确认迁移和实际表结构完全一致时用否则不要碰。5.3 出版日期保存后不变auto_now_add 的玄学现象给 pub_date 加了 auto_now_addTrue新增时日期自动填了当前时间但编辑时表单里根本没有这个字段保存后日期也不变。原因auto_now_add 只在记录创建的那一刻写入当前时间之后永远不会变化表单也不会渲染它。它是给 created_at 这类审计字段设计的不是给业务日期设计的。解决出版日期是业务数据应该用普通 DateField让用户在表单里手动选择。auto_now_add 留给「创建时间」如果还需要「最后修改时间」用 auto_nowTrue它会在每次 save 时更新。5.4 删除出版社把书删光了on_delete 行为差异现象在 Admin 里删一个出版社要么提示 ProtectedError 删不掉要么出版社没了它下面所有的图书也没了。原因外键的 on_delete 参数决定了删除关联对象时的行为CASCADE 会把图书连带删光PROTECT 会阻止删除并抛异常这俩语义完全不同选错代价很大。解决按业务重要性选。图书数据通常比出版社信息金贵我用 PROTECT删不掉就说明下面有书先处理图书再删出版社。如果业务允许书在出版社删除后保留外键加 nullTrue、blankTrue用 SET_NULL图书保留但出版社变成空。三种行为对比如下on_delete 选项删除出版社时的行为适用场景CASCADE连带删除所有图书图书没有保留价值PROTECT抛 ProtectedError禁止删除图书数据重要SET_NULL图书保留外键置为 NULL允许图书无出版社5.5 搜索后翻页搜索条件丢了现象按书名搜索「Django」结果有两页点第 2 页页面变成全部图书的第 2 页搜索条件没了。原因分页链接只拼了 page 参数没有带上 q。模板里如果写href?page{{ page.next_page_number }}翻页必然丢失搜索条件。解决分页链接里把 q 一起拼回去注意用 urlencode 过滤特殊字符a classpage-link href?page{{ page.next_page_number }}{% if q %}q{{ q|urlencode }}{% endif %} 下一页 /a这个坑在后面第 6 章做分页组件时我会直接内置进去避免每个列表页各踩一遍。6. 把分页和搜索条件打包成一个模板组件include 与模板继承的最后一块拼图图书列表、作者列表、出版社列表三个页面都需要分页而且都要保留搜索参数。与其在每个模板里复制粘贴那一堆上一页下一页的判断不如拆成一个公共组件。在 templates/partials/ 下新建 _pagination.html!-- books/templates/partials/_pagination.html -- {% if page.has_other_pages %} nav aria-label列表分页 ul classpagination justify-content-center {% if page.has_previous %} li classpage-item a classpage-link href?page{{ page.previous_page_number }}{% if q %}q{{ q|urlencode }}{% endif %} 上一页 /a /li {% endif %} li classpage-item disabled span classpage-link{{ page.number }} / {{ page.paginator.num_pages }}/span /li {% if page.has_next %} li classpage-item a classpage-link href?page{{ page.next_page_number }}{% if q %}q{{ q|urlencode }}{% endif %} 下一页 /a /li {% endif %} /ul /nav {% endif %}在列表页底部一行引入{% include partials/_pagination.html %}include 默认继承当前模板的上下文只要视图里传了 page 和 q组件里直接用就行。如果某个页面的变量名不一样也可以用{% include partials/_pagination.html with pagepaginator_obj qkeyword %}显式传参。这就是这个组件的全部价值把第 5 章说过的搜索参数保留问题在组件层面解决掉而不是靠每个开发者记得拼参数。我交付前会再做两件事一是在空数据库里跑一遍列表页和表单页确认空状态、必填校验都正常二是造一条超长书名、一个挂了十几位作者的图书看看表格布局会不会被撑坏。这两个场景比正常数据更容易暴露翻车问题做多了就成了习惯。希望帮到你。本文还有配套的精品资源点击获取
