面向：Web 初学者、信息与计算科学/信息资源管理相关专业学生、想快速搭建科研工具的人。
本仓库是一份我在毕设过程中整理的系统性 Web 开发知识手册，涵盖从基础概念到项目落地的完整链路。它不是传统意义上逐条罗列语法的“教程”，而是一张以“理解系统运行逻辑”为目标的开发地图——帮助你搞懂 Web 系统全貌，学会用 AI 辅助开发，遇到报错知道去哪查。
📄 完整手册：🌐 现代 Web 开发参考手册 2.0.md
本手册目前有两个版本：
| 版本 | 状态 | 说明 |
|---|---|---|
| v1.0 | 已归档 | 对应毕业设计初版，技术栈为 Flask + 原生 SQL + Jinja2 模板渲染 |
| v2.0 | 当前版本 | 对应毕业设计最终版，全面重构，新增全文检索、引用关系管理、数据统计、浏览历史、高级筛选、登录锁定等功能 |
当前仓库为 v2.0 版本，第 10 章“项目开发完整流程”已基于 v2.0 实际开发过程同步更新。
这本手册的写作出发点是：传统 Web 学习通常从“HTML 标签 → CSS 属性 → JavaScript 语法 → 服务器配置 → 数据库连接”开始，很多人学完后知道“这个标签怎么写”，但仍然不清楚“一个网站到底是怎么跑起来的”。
现在做 Web 开发，早就不用一个人硬啃几万行代码。这本手册的核心逻辑是： 你提出需求 → AI 生成代码 → 你看懂结构 → 你修改维护 → 系统上线
text
因此手册不讲具体语法细节，而是聚焦于三个任务：
- 搞清楚概念（这玩意儿是干嘛的）
- 看懂系统架构（它放在哪一层、跟谁打交道）
- 学会怎么跟 AI 描述需求（让它帮你干活）
手册共 12 个章节，从 Web 基础知识覆盖到项目实战落地：
- 第 1-3 章：Web 本质、服务器、浏览器、三大核心板块（前端/后端/数据库）
- 第 4 章：前端基础（HTML/CSS/JavaScript）
- 第 5 章：现代前端框架概述（Vue/React/Angular）
- 第 6 章：后端基础（服务器、API、动态网页技术演进）
- 第 7 章：数据库（关系型数据库、SQL、ORM）
- 第 8 章：HTTP 通信（请求方法、状态码、JSON、Ajax）
- 第 9 章：用户登录与权限（登录流程、Token/JWT）
- 第 10 章：项目开发完整流程（需求分析→系统设计→技术选型→开发→联调→部署）—— 已同步至 v2.0 实际开发状态
- 第 11 章：AI 配合模板（前端/后端/数据库/报错/部署/RAG 等 12 类模板，新增 3 个 v2.0 场景模板）
- 第 12 章：报错排查速查表（前端/后端/联调/Flask 专用）
手册采用口语化风格，以“南农教务系统”“农业文献检索系统”等贴近信息资源管理专业的场景贯穿始终，便于理解和迁移。
本手册的技术选型和实践案例来源于我的毕设项目：
👉 AcademicSearchSystem —— 基于 Flask + SQL Server 的学术文献检索系统，支持多维度检索、文献上传/下载、引用关系管理、收藏功能、数据统计等。手册第 10 章中的项目开发流程即以此项目为实例展开。
- Web 开发初学者，想建立系统认知而非零散语法
- 信息与计算科学/信息资源管理等非纯计算机专业学生
- 准备课程设计或毕业设计，想快速搭建科研工具的人
- 希望学习如何用 AI 辅助完成 Web 开发的开发者
- 不背代码：理解概念和架构，具体语法交给 AI
- 口语化讲解：用“门面/后厨/冰箱”这类生活类比理解三层架构
- 南农场景贯穿：以教务系统、图书馆、农业文献检索为案例
- 配套项目支撑：手册中的技术选型与毕设项目保持一致
- 版本同步：v2.0 手册与项目代码状态完全对齐
手册涉及的技术包括但不限于：
| 领域 | 技术 |
|---|---|
| 前端 | HTML / CSS / JavaScript / Tailwind CSS / Jinja2 |
| 前端框架 | Vue 3 / React / Angular（概述） |
| 后端 | Python + Flask / FastAPI / Java Spring Boot（对比） |
| 数据库 | SQL Server / MySQL / PostgreSQL / ORM（SQLAlchemy） |
| 通信 | HTTP / JSON / XML / Ajax |
| 认证 | Session / Cookie / JWT |
| PDF 解析 | pdfplumber |
| 开发工具 | PyCharm / VS Code / SSMS / Git / GitHub / Obsidian |
版权所有 © 2026 丁俊杰（南京农业大学）
本文档为《学术文献检索系统》毕业设计项目的附属开发文档，受《中华人民共和国著作权法》保护。
您被允许：
- ✅ 查看与学习：浏览、阅读本文档全部内容，作为 Web 开发的参考资料
- ✅ 转载分享：在保留完整版权声明及原作者信息的前提下，通过社交媒体、博客、论坛等渠道转载本文档
- ✅ 课堂引用：教师在课堂上引用本文档内容作为教学素材（须注明出处）
您被禁止：
- ❌ 商业使用：不得将本文档或其任何部分用于商业目的（包括但不限于出版销售、付费课程、企业内部培训等）
- ❌ 修改后发布：不得对本文档进行修改、改编、删减后以自己名义重新发布
- ❌ 学术抄袭：严禁将本文档的整体结构、章节编排、核心论述等稍作修改后作为自己的课程作业、毕业论文或其他学术成果提交
本文档为作者独立完成的 Web 开发知识体系整理，任何个人或组织若参考本文档进行课程设计、毕业设计或其他学术用途，必须在参考文献或致谢中明确标注本文档的出处，严禁整体或部分抄袭后作为自己的成果提交。
转载时请注明出处：
- 作者：丁俊杰（hainuo1）
- 学校：南京农业大学 · 信息与计算科学专业
- 关联项目：https://github.com/hainuo1/AcademicSearchSystem
- 联系方式：hainuo@stu.njau.edu.cn
⭐ 如果这本手册对你有帮助，欢迎点亮 Star！