简介面向Python毕业设计及课程设计的智能旅游推荐系统实战项目包内置完整前后端代码与数据库脚本适合需要快速搭建可运行项目的中级Python学习者。系统功能完善、界面美观覆盖旅游信息展示、线路推荐、后台管理等典型业务模块既可作为毕业设计选题也适用于课程设计及项目实训。资源共797个文件压缩包约20.19MB包含164个js、53个vue、53个css、53个html等前端页面与交互逻辑45个py与40个pyc构成后台处理模块另有2个sql数据库脚本、bat启动脚本、md说明文档及少量配置文件各类文件按功能分层组织vue组件对应页面模块js与css负责界面效果py文件承载核心业务sql脚本用于快速建库整体目录结构清晰便于按模块检视和二次开发。项目经严格调试可直接运行数据库脚本与启动脚本齐全可帮助读者快速理清从环境配置到系统上线的完整链条。目前已有132人学习下载对需要参考完整项目实现、完善毕设功能或学习前后端协作的同学具有较高参考价值。1. 基于 Python 的智能旅游推荐系统这份毕业设计源码能直接跑吗做 Python 毕业设计最怕的不是没思路而是找了一份源码打开后发现缺数据库、缺依赖、前端后端对不上光配环境就耗掉一周。这份「基于 Python 的智能旅游推荐系统」压缩包我拆完之后确认了一下源码、数据库脚本、启动脚本都在前端是 Vue 写的管理后台页面后端是 Python 接口数据库用的 MySQL还附带安装.bat 和运行.bat 两个一键脚本属于典型的全栈毕设结构。它的价值在于不是只给个 Flask 裸接口而是把后台管理界面、登录鉴权、景点数据管理、推荐逻辑串成了一条完整链路适合做 Python 课程设计、毕业设计二开也适合想快速补齐前后端分离项目经验的人。拿到手之后能不能 10 分钟跑起来取决于你的 Python 版本和 MySQL 环境这个我后面会逐个拆。2. 系统架构与核心设计Vue 前端 Python 后端 MySQL 是怎么拼起来的2.1 从 .bak 文件反推项目结构六个关键文件在系统里各管什么压缩包里的文件后缀是 .bak这点很关键。index.html.bak、update-password.vue.bak、IndexMain.vue.bak、IndexAsideStatic.vue.bak、BreadCrumbs.vue.bak、IndexHeader.vue.bak这些不是垃圾文件而是原作者在改版时留下的备份。为什么要用 .bak 而不是直接删掉因为 Vue 单文件组件在开发阶段改坏是常事留一份确认可运行的版本相当于给自己留后悔药。我一般拿到这类项目的第一件事就是把 .bak 批量重命名回去再跑或者逐个对照副本和主文件的差异这能反推出系统原本的页面结构。备份文件在系统中的角色对应界面位置index.html.bak前端入口页面浏览器加载的第一个 HTMLIndexMain.vue.bak主内容区组件后台布局的正中间内容区域IndexHeader.vue.bak顶部导航栏组件页面顶部的 Logo、用户信息、退出按钮IndexAsideStatic.vue.bak静态侧边菜单组件左侧菜单栏含景点管理、用户管理等入口BreadCrumbs.vue.bak面包屑导航组件Header 下方的路径提示比如「首页 / 景点管理」update-password.vue.bak修改密码弹窗组件用户点击修改密码后弹出的表单这个结构说明前端不是一堆零散 HTML 拼出来的而是走 Vue 组件化入口页加载 Header、Aside、MainMain 里再动态塞入各个业务页面。后端则提供对应的登录接口、景点增删改查接口、推荐接口前端通过 HTTP 请求调后端拿数据渲染成表格、表单和列表。理解了这个分工后面不管是部署还是二次开发都知道该去哪个文件里改。2.2「智能推荐」的实现思路协同过滤在这个场景下怎么落既然是智能旅游推荐系统核心卖点在推荐算法。这类 Python 毕设项目里最常用的是协同过滤分基于用户UserCF和基于物品ItemCF两种。旅游场景下推荐景点用 ItemCF 更符合直觉先算景点之间的相似度然后根据用户收藏、浏览、评分的景点找出相似景点推荐给他。相似度计算通常用余弦相似度公式是cos(A, B) A·B / (|A|×|B|)把每个景点对应用户行为的向量表示两个景点向量夹角越小说明被同一批用户喜欢得越多相似度越高。这套逻辑落到代码里大致是三步第一步从数据库读用户行为表把「用户-景点-评分」整理成矩阵第二步对目标用户收藏过的每个景点找相似度最高的 N 个景点第三步过滤掉用户已经去过的按相似度加权排序返回。毕设答辩时把这个流程画清楚比空喊「智能」两个字有说服力得多。2.3 数据库设计MySQL 里该有哪些表为什么这样拆推荐系统跑起来依赖三块数据用户、景点、用户行为。对应的 MySQL 表一般至少会有用户表、景点信息表、收藏表、评论表如果需要做评分推荐还得加评分表。用户表存账号密码和角色景点表存名称、城市、分类、简介、图片地址收藏表记录用户收藏了哪些景点评论表存用户对景点的评价。用户和景点之间是多对多关系通过收藏表和评论表把两边的关联拆开这是标准的三范式设计也是答辩时会被问到的基础点。数据库脚本在压缩包里是以 .sql 形式提供的用 Navicat 打开执行就能建库建表。我拆包时关注了一下脚本里的字符集设置——如果建表语句用的是 utf8mb4 而不是 utf8导入时遇到 emoji 或生僻地名容易报错这一点在后面的避坑章节我会专门讲。3. 部署全流程PyCharm Python 3.7 MySQL 从零跑通3.1 环境准备版本匹配是第一道坎这个项目标注的建议环境是 Python 3.7 PyCharm MySQL Navicat。版本不要随意升级我见过不少人用 Python 3.12 去跑老毕设项目结果 pip 装依赖时一堆兼容性报错——不是项目有问题是语言版本太新旧依赖包还没适配。装 Python 之前先确认一件事安装时勾选「Add Python to PATH」否则后面在命令行里敲 python 会提示找不到命令这一步是 python 安装教程里最常见的坑。MySQL 建议用 5.7 或 8.0。装完 MySQL 后要记住 root 密码后面改连接配置要用。Navicat 主要是用来导入数据库脚本和查看数据也可以换成 DBeaver 或命令行但毕设项目里给的操作文档一般默认用 Navicat按它走最顺。3.2 前端页面拆解布局组件、鉴权逻辑与二次改造位置前端由 HTML 页面与 Vue 组件共同组成index.html是单页应用的 HTML 入口页面通过 JavaScript 动态渲染。所有后端返回的页面均由系统内 Vue 组件渲染以下结构是作者在开发环境下的原始布局解压后建议直接浏览源码确认实际结构。修改页面文案、菜单名称、Logo 时通常需要改动以下区域站点名称位于 HTML 页面的title标签顶部用户区由IndexHeader.vue渲染含用户昵称、头像、退出登录左侧菜单由IndexAsideStatic.vue渲染静态菜单项如景点管理、用户管理内容区域由IndexMain.vue渲染不同路由切换不同子页面修改密码由update-password.vue渲染是通过弹窗方式打开的表单把菜单从「景点管理」改成「旅游路线管理」只需要打开IndexAsideStatic.vue找到对应的菜单数组改title字段。推荐逻辑集中在后端推荐模块前端只负责把推荐结果以卡片列表形式展示在首页接口返回的字段通常包含景点名称、图片、推荐理由前端拿到后渲染即可。3.3 后端接口的调用链条从登录到推荐的完整请求流梳理一遍请求流会对系统运转有整体认知。用户在登录页输入账号密码前端把参数 POST 给后端的/api/login接口后端查用户表校验密码成功后返回 token前端把 token 存到 localStorage。之后每次请求景点列表、提交收藏、获取推荐请求头里都带上这个 token后端通过 token 识别用户身份。控制台打开 Network 面板能看到如下关键请求POST /api/login登录参数是用户名和密码GET /api/scenic/list获取景点列表支持关键词搜索和分类筛选POST /api/collect收藏景点参数是景点 IDGET /api/recommend获取针对当前用户的推荐景点列表后端接口代码一般写在app.py或views.py里用 Flask 的话通常是路由装饰器加函数处理。调试接口时不用前端页面直接在浏览器地址栏输入http://127.0.0.1:5000/api/scenic/list能返回 JSON 就说明后端通了。这套「前端调接口、后端查数据库」的模式就是毕设答辩时最值得展开讲的业务闭环。4. 一键脚本背后的执行逻辑安装.bat 和运行.bat 到底干了什么4.1 批处理脚本解读两条命令拆解压缩包根目录下的安装.bat、2-run.bat、3-build.bat、运行.bat是 Windows 环境下的启动捷径。双击「安装.bat」通常做两件事一是检测当前目录有没有 Python 环境二是执行pip install -r requirements.txt安装所有依赖。因为它本质就是把命令行操作包装成双击执行所以第一次运行建议右键选「以管理员身份运行」避免写入 Python 安装目录时被权限拦截。依赖数量多时窗口会长时间停在安装阶段这不是卡死是 pip 正在下载日志里能看到包名滚动。运行类脚本的角色划分一般是这样的2-run.bat负责启动后端服务比如执行python app.py3-build.bat负责前端构建把 Vue 源码打包成静态文件。运行.bat则是把前后端串起来的一键入口也可能只是启动后端并把浏览器自动打开到管理后台地址。如果双击后闪退看不到报错信息就用命令行手动执行脚本里的原始命令报错才能留在屏幕上。4.2 手动部署方案脚本跑不通时的兜底路径不想依赖 .bat或者你用的是 macOS / Linux手动部署也很直接。第一步用 PyCharm 打开项目根目录设置解释器指向 Python 3.7第二步在 PyCharm 终端执行依赖安装pip install -r requirements.txt安装完成后先启动数据库服务再用 Navicat 执行压缩包里的 .sql 脚本建库。然后启动后端python app.py看到Running on http://127.0.0.1:5000之类的日志就是后端起来了。如果项目带独立前端目录再开一个终端cd frontend npm install npm run serve前端启动后访问http://127.0.0.1:8080管理后台页面就能打开填后端的地址和端口进行联调。4.3 依赖清单里容易被忽略的包requirements.txt里除了 Flask 或 Django 这类主框架还会有一堆工具库。常见的包括Flask-SQLAlchemy做数据库映射、Flask-CORS处理跨域、requests做 HTTP 调用、pandas和numpy用来算推荐相似度矩阵。其中pandas和numpy在 Windows 上安装速度慢如果 pip 卡住换成国内镜像源能快很多具体命令在避坑章节里给。装完依赖后建议执行一遍pip list核对版本号确认关键包没被装成兼容性差的版本比如 Flask 装成了 3.x 而代码按 2.x 写法写的路由装饰器可能会有行为差异。5. 避坑与常见问题从 pip 依赖到 MySQL 连接的五个实战记录做毕设项目最耗时间的不是写代码而是踩环境坑。以下五条是我在实际拆解这类项目时遇到的高频问题现象、原因、解决一条条说清楚。5.1 pip 安装依赖超时或直接报错现象运行「安装.bat」或执行pip install -r requirements.txt时进度条卡在某个包上很久最后报Read timed out或Connection reset by peer。原因pip 默认走国外源仓库国内网络环境访问不稳定尤其是 pandas 这种体积大的包下载到一半连接被断开。解决临时指定清华镜像源重装pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple也可以把镜像源写成全局配置执行一次pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple后面所有安装都走镜像不用每次带参数。如果单个包反复失败单独装这一个再继续。5.2 双击 .bat 后窗口闪退看不到任何报错现象双击「运行.bat」黑色命令行窗口一闪而过系统没有启动成功也没有留下日志。原因脚本执行到某条命令报错退出但 .bat 窗口没有加pause暂停语句错误信息随窗口关闭一起消失。解决用命令行手动执行脚本里的每一条命令。最简单的做法是在项目目录下按住 Shift 右键打开命令行输入脚本文件名按回车或者在 PyCharm 终端里逐条执行。也可以给 .bat 文件末尾手动加一行pause再双击就能看到报错信息停在屏幕上。5.3 Navicat 导入 .sql 脚本报 1064 语法错误现象Navicat 执行数据库脚本时报[Err] 1064 - You have an error in your SQL syntax但脚本在压缩包里没动过。原因大概率是字符集不匹配。某些老脚本用的utf8只支持基础字符遇到生僻字或特殊符号时语法解析异常另一种可能是 Navicat 连接的 MySQL 版本和脚本生成时的版本差异太大比如脚本是 MySQL 5.6 的你连的是 8.0某些字段类型的默认值写法不兼容。解决在 Navicat 新建一个链接时把编码显式选为 utf8mb4然后新建数据库字符集同样选 utf8mb4再双击打开这个库执行脚本。如果是版本差异把脚本里的ENGINEInnoDB DEFAULT CHARSETutf8替换成ENGINEInnoDB DEFAULT CHARSETutf8mb4再执行基本能过。5.4 后端启动报错连接不上 MySQL现象执行python app.py后日志里出现Cant connect to MySQL server或Access denied for user rootlocalhost。原因配置文件里的数据库地址、用户名或密码跟你本机不一致。常见情况是配置文件写的是password: 123456你装 MySQL 时设的密码是root123连不上的原因就出在这。解决找到项目里的数据库配置文件通常是config.py或db.py把连接字符串改成自己本机的账号密码app.config[SQLALCHEMY_DATABASE_URI] mysqlpymysql://root:你的密码127.0.0.1:3306/travel_db?charsetutf8mb4这里root是用户名你的密码改成实际密码travel_db改成脚本建出来的数据库名。改完重启后端。另外确认 MySQL 服务已启动Windows 下可以在任务管理器「服务」页看 MySQL80 之类的服务是否在运行。5.5 前端能打开但接口请求全部失败登录都没反应现象管理后台首页正常显示但输入账号密码点登录一直转圈或提示网络错误浏览器 F12 里看到请求红色报错。原因前后端地址或端口不通。一种情况是后端端口是 5000前端代码里写的接口地址是http://localhost:5000没问题另一种情况是后端根本还没启动或者把端口写成了 8000。也有跨域问题前端在 8080 端口后端在 5000 端口跨域没处理浏览器默认拦截响应。解决先确认后端已启动访问http://127.0.0.1:5000/api/scenic/list能返回 JSON。能返回但前端请求失败就是跨域问题后端加 CORS 支持from flask_cors import CORS CORS(app)把这两行加在 Flask 实例初始化之后重启后端即可。6. 把推荐逻辑落到答辩从相似度计算到演示动线设计答辩环节最容易露怯的就是「智能推荐」四个字讲不实。面试老师或答辩评委通常会追问三连推荐算法具体是什么相似度怎么算推荐结果怎么生成的如果只能说「代码里有实现」会显得没有消化。下面这段代码是协同过滤推荐模块的核心计算拿到源码后对照着定位到自己的项目里逐行看懂。import numpy as np # 构建 用户-物品 评分矩阵 # 行索引为用户ID列索引为景点ID没有行为记0分 user_item_matrix [ [5, 0, 3, 0], [4, 0, 0, 2], [0, 3, 4, 5], [3, 4, 0, 1], ] def cosine_similarity(list_a, list_b): 计算两个景点的余弦相似度 dot_product np.dot(list_a, list_b) norm_a np.linalg.norm(list_a) norm_b np.linalg.norm(list_b) if norm_a 0 or norm_b 0: return 0 return dot_product / (norm_a * norm_b) # 计算景点之间的相似度矩阵 # item_matrix 的每一列为同一景点在不同用户下的评分 item_matrix np.array(user_item_matrix).T movie_count item_matrix.shape[0] similarity_matrix np.zeros((movie_count, movie_count)) for i in range(movie_count): for j in range(movie_count): similarity_matrix[i][j] cosine_similarity(item_matrix[i], item_matrix[j])cosine_similarity函数接收两个向量先算点积再除以模长乘积得到的值在 0 到 1 之间越接近 1 表示两个景点被同一批用户喜欢的程度越高。双层循环里逐个景点求相似度最终得到对称的相似度矩阵拿这个矩阵给目标用户推荐收藏景点最相似的 Top-N 个。毕设演示时建议按这条动线走管理员登录后台 → 添加几个新景点 → 切换到普通用户 → 浏览并收藏两个景点 → 回到推荐页看到相似景点推了回来。这条链路短、可视、逻辑完整评委能直观看到推荐系统从输入到输出的过程比对着代码讲更有说服力。演示前把账号密码和数据库状态确认好。我从那次 demo 翻车后养成了习惯每次演示前强制走一遍「重启 MySQL → 启动后端 → 打开前端 → 登录 → 收藏一个景点 → 查看推荐结果」的完整流程顺序一步不错。这份项目源码结构清晰适合在上面做二次开发希望能帮到你。另外提醒一点拿到压缩包先完整解压不要在压缩包内直接双击 .bat。有用户习惯用 WinRAR 的预览功能直接执行压缩包里的脚本结果脚本找不到当前目录下的依赖文件报No such file or directory。解压后建议把文件夹路径里的中文和空格去掉比如放到D:\travel_recommend某些 Python 包在带中文的路径下会出现编码异常这个细节能省掉一堆莫名其妙的问题。本文还有配套的精品资源点击获取 Python智能旅游推荐系统毕设全解析：Vue+Flask+MySQL协同过滤部署指南
简介面向Python毕业设计及课程设计的智能旅游推荐系统实战项目包内置完整前后端代码与数据库脚本适合需要快速搭建可运行项目的中级Python学习者。系统功能完善、界面美观覆盖旅游信息展示、线路推荐、后台管理等典型业务模块既可作为毕业设计选题也适用于课程设计及项目实训。资源共797个文件压缩包约20.19MB包含164个js、53个vue、53个css、53个html等前端页面与交互逻辑45个py与40个pyc构成后台处理模块另有2个sql数据库脚本、bat启动脚本、md说明文档及少量配置文件各类文件按功能分层组织vue组件对应页面模块js与css负责界面效果py文件承载核心业务sql脚本用于快速建库整体目录结构清晰便于按模块检视和二次开发。项目经严格调试可直接运行数据库脚本与启动脚本齐全可帮助读者快速理清从环境配置到系统上线的完整链条。目前已有132人学习下载对需要参考完整项目实现、完善毕设功能或学习前后端协作的同学具有较高参考价值。1. 基于 Python 的智能旅游推荐系统这份毕业设计源码能直接跑吗做 Python 毕业设计最怕的不是没思路而是找了一份源码打开后发现缺数据库、缺依赖、前端后端对不上光配环境就耗掉一周。这份「基于 Python 的智能旅游推荐系统」压缩包我拆完之后确认了一下源码、数据库脚本、启动脚本都在前端是 Vue 写的管理后台页面后端是 Python 接口数据库用的 MySQL还附带安装.bat 和运行.bat 两个一键脚本属于典型的全栈毕设结构。它的价值在于不是只给个 Flask 裸接口而是把后台管理界面、登录鉴权、景点数据管理、推荐逻辑串成了一条完整链路适合做 Python 课程设计、毕业设计二开也适合想快速补齐前后端分离项目经验的人。拿到手之后能不能 10 分钟跑起来取决于你的 Python 版本和 MySQL 环境这个我后面会逐个拆。2. 系统架构与核心设计Vue 前端 Python 后端 MySQL 是怎么拼起来的2.1 从 .bak 文件反推项目结构六个关键文件在系统里各管什么压缩包里的文件后缀是 .bak这点很关键。index.html.bak、update-password.vue.bak、IndexMain.vue.bak、IndexAsideStatic.vue.bak、BreadCrumbs.vue.bak、IndexHeader.vue.bak这些不是垃圾文件而是原作者在改版时留下的备份。为什么要用 .bak 而不是直接删掉因为 Vue 单文件组件在开发阶段改坏是常事留一份确认可运行的版本相当于给自己留后悔药。我一般拿到这类项目的第一件事就是把 .bak 批量重命名回去再跑或者逐个对照副本和主文件的差异这能反推出系统原本的页面结构。备份文件在系统中的角色对应界面位置index.html.bak前端入口页面浏览器加载的第一个 HTMLIndexMain.vue.bak主内容区组件后台布局的正中间内容区域IndexHeader.vue.bak顶部导航栏组件页面顶部的 Logo、用户信息、退出按钮IndexAsideStatic.vue.bak静态侧边菜单组件左侧菜单栏含景点管理、用户管理等入口BreadCrumbs.vue.bak面包屑导航组件Header 下方的路径提示比如「首页 / 景点管理」update-password.vue.bak修改密码弹窗组件用户点击修改密码后弹出的表单这个结构说明前端不是一堆零散 HTML 拼出来的而是走 Vue 组件化入口页加载 Header、Aside、MainMain 里再动态塞入各个业务页面。后端则提供对应的登录接口、景点增删改查接口、推荐接口前端通过 HTTP 请求调后端拿数据渲染成表格、表单和列表。理解了这个分工后面不管是部署还是二次开发都知道该去哪个文件里改。2.2「智能推荐」的实现思路协同过滤在这个场景下怎么落既然是智能旅游推荐系统核心卖点在推荐算法。这类 Python 毕设项目里最常用的是协同过滤分基于用户UserCF和基于物品ItemCF两种。旅游场景下推荐景点用 ItemCF 更符合直觉先算景点之间的相似度然后根据用户收藏、浏览、评分的景点找出相似景点推荐给他。相似度计算通常用余弦相似度公式是cos(A, B) A·B / (|A|×|B|)把每个景点对应用户行为的向量表示两个景点向量夹角越小说明被同一批用户喜欢得越多相似度越高。这套逻辑落到代码里大致是三步第一步从数据库读用户行为表把「用户-景点-评分」整理成矩阵第二步对目标用户收藏过的每个景点找相似度最高的 N 个景点第三步过滤掉用户已经去过的按相似度加权排序返回。毕设答辩时把这个流程画清楚比空喊「智能」两个字有说服力得多。2.3 数据库设计MySQL 里该有哪些表为什么这样拆推荐系统跑起来依赖三块数据用户、景点、用户行为。对应的 MySQL 表一般至少会有用户表、景点信息表、收藏表、评论表如果需要做评分推荐还得加评分表。用户表存账号密码和角色景点表存名称、城市、分类、简介、图片地址收藏表记录用户收藏了哪些景点评论表存用户对景点的评价。用户和景点之间是多对多关系通过收藏表和评论表把两边的关联拆开这是标准的三范式设计也是答辩时会被问到的基础点。数据库脚本在压缩包里是以 .sql 形式提供的用 Navicat 打开执行就能建库建表。我拆包时关注了一下脚本里的字符集设置——如果建表语句用的是 utf8mb4 而不是 utf8导入时遇到 emoji 或生僻地名容易报错这一点在后面的避坑章节我会专门讲。3. 部署全流程PyCharm Python 3.7 MySQL 从零跑通3.1 环境准备版本匹配是第一道坎这个项目标注的建议环境是 Python 3.7 PyCharm MySQL Navicat。版本不要随意升级我见过不少人用 Python 3.12 去跑老毕设项目结果 pip 装依赖时一堆兼容性报错——不是项目有问题是语言版本太新旧依赖包还没适配。装 Python 之前先确认一件事安装时勾选「Add Python to PATH」否则后面在命令行里敲 python 会提示找不到命令这一步是 python 安装教程里最常见的坑。MySQL 建议用 5.7 或 8.0。装完 MySQL 后要记住 root 密码后面改连接配置要用。Navicat 主要是用来导入数据库脚本和查看数据也可以换成 DBeaver 或命令行但毕设项目里给的操作文档一般默认用 Navicat按它走最顺。3.2 前端页面拆解布局组件、鉴权逻辑与二次改造位置前端由 HTML 页面与 Vue 组件共同组成index.html是单页应用的 HTML 入口页面通过 JavaScript 动态渲染。所有后端返回的页面均由系统内 Vue 组件渲染以下结构是作者在开发环境下的原始布局解压后建议直接浏览源码确认实际结构。修改页面文案、菜单名称、Logo 时通常需要改动以下区域站点名称位于 HTML 页面的title标签顶部用户区由IndexHeader.vue渲染含用户昵称、头像、退出登录左侧菜单由IndexAsideStatic.vue渲染静态菜单项如景点管理、用户管理内容区域由IndexMain.vue渲染不同路由切换不同子页面修改密码由update-password.vue渲染是通过弹窗方式打开的表单把菜单从「景点管理」改成「旅游路线管理」只需要打开IndexAsideStatic.vue找到对应的菜单数组改title字段。推荐逻辑集中在后端推荐模块前端只负责把推荐结果以卡片列表形式展示在首页接口返回的字段通常包含景点名称、图片、推荐理由前端拿到后渲染即可。3.3 后端接口的调用链条从登录到推荐的完整请求流梳理一遍请求流会对系统运转有整体认知。用户在登录页输入账号密码前端把参数 POST 给后端的/api/login接口后端查用户表校验密码成功后返回 token前端把 token 存到 localStorage。之后每次请求景点列表、提交收藏、获取推荐请求头里都带上这个 token后端通过 token 识别用户身份。控制台打开 Network 面板能看到如下关键请求POST /api/login登录参数是用户名和密码GET /api/scenic/list获取景点列表支持关键词搜索和分类筛选POST /api/collect收藏景点参数是景点 IDGET /api/recommend获取针对当前用户的推荐景点列表后端接口代码一般写在app.py或views.py里用 Flask 的话通常是路由装饰器加函数处理。调试接口时不用前端页面直接在浏览器地址栏输入http://127.0.0.1:5000/api/scenic/list能返回 JSON 就说明后端通了。这套「前端调接口、后端查数据库」的模式就是毕设答辩时最值得展开讲的业务闭环。4. 一键脚本背后的执行逻辑安装.bat 和运行.bat 到底干了什么4.1 批处理脚本解读两条命令拆解压缩包根目录下的安装.bat、2-run.bat、3-build.bat、运行.bat是 Windows 环境下的启动捷径。双击「安装.bat」通常做两件事一是检测当前目录有没有 Python 环境二是执行pip install -r requirements.txt安装所有依赖。因为它本质就是把命令行操作包装成双击执行所以第一次运行建议右键选「以管理员身份运行」避免写入 Python 安装目录时被权限拦截。依赖数量多时窗口会长时间停在安装阶段这不是卡死是 pip 正在下载日志里能看到包名滚动。运行类脚本的角色划分一般是这样的2-run.bat负责启动后端服务比如执行python app.py3-build.bat负责前端构建把 Vue 源码打包成静态文件。运行.bat则是把前后端串起来的一键入口也可能只是启动后端并把浏览器自动打开到管理后台地址。如果双击后闪退看不到报错信息就用命令行手动执行脚本里的原始命令报错才能留在屏幕上。4.2 手动部署方案脚本跑不通时的兜底路径不想依赖 .bat或者你用的是 macOS / Linux手动部署也很直接。第一步用 PyCharm 打开项目根目录设置解释器指向 Python 3.7第二步在 PyCharm 终端执行依赖安装pip install -r requirements.txt安装完成后先启动数据库服务再用 Navicat 执行压缩包里的 .sql 脚本建库。然后启动后端python app.py看到Running on http://127.0.0.1:5000之类的日志就是后端起来了。如果项目带独立前端目录再开一个终端cd frontend npm install npm run serve前端启动后访问http://127.0.0.1:8080管理后台页面就能打开填后端的地址和端口进行联调。4.3 依赖清单里容易被忽略的包requirements.txt里除了 Flask 或 Django 这类主框架还会有一堆工具库。常见的包括Flask-SQLAlchemy做数据库映射、Flask-CORS处理跨域、requests做 HTTP 调用、pandas和numpy用来算推荐相似度矩阵。其中pandas和numpy在 Windows 上安装速度慢如果 pip 卡住换成国内镜像源能快很多具体命令在避坑章节里给。装完依赖后建议执行一遍pip list核对版本号确认关键包没被装成兼容性差的版本比如 Flask 装成了 3.x 而代码按 2.x 写法写的路由装饰器可能会有行为差异。5. 避坑与常见问题从 pip 依赖到 MySQL 连接的五个实战记录做毕设项目最耗时间的不是写代码而是踩环境坑。以下五条是我在实际拆解这类项目时遇到的高频问题现象、原因、解决一条条说清楚。5.1 pip 安装依赖超时或直接报错现象运行「安装.bat」或执行pip install -r requirements.txt时进度条卡在某个包上很久最后报Read timed out或Connection reset by peer。原因pip 默认走国外源仓库国内网络环境访问不稳定尤其是 pandas 这种体积大的包下载到一半连接被断开。解决临时指定清华镜像源重装pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple也可以把镜像源写成全局配置执行一次pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple后面所有安装都走镜像不用每次带参数。如果单个包反复失败单独装这一个再继续。5.2 双击 .bat 后窗口闪退看不到任何报错现象双击「运行.bat」黑色命令行窗口一闪而过系统没有启动成功也没有留下日志。原因脚本执行到某条命令报错退出但 .bat 窗口没有加pause暂停语句错误信息随窗口关闭一起消失。解决用命令行手动执行脚本里的每一条命令。最简单的做法是在项目目录下按住 Shift 右键打开命令行输入脚本文件名按回车或者在 PyCharm 终端里逐条执行。也可以给 .bat 文件末尾手动加一行pause再双击就能看到报错信息停在屏幕上。5.3 Navicat 导入 .sql 脚本报 1064 语法错误现象Navicat 执行数据库脚本时报[Err] 1064 - You have an error in your SQL syntax但脚本在压缩包里没动过。原因大概率是字符集不匹配。某些老脚本用的utf8只支持基础字符遇到生僻字或特殊符号时语法解析异常另一种可能是 Navicat 连接的 MySQL 版本和脚本生成时的版本差异太大比如脚本是 MySQL 5.6 的你连的是 8.0某些字段类型的默认值写法不兼容。解决在 Navicat 新建一个链接时把编码显式选为 utf8mb4然后新建数据库字符集同样选 utf8mb4再双击打开这个库执行脚本。如果是版本差异把脚本里的ENGINEInnoDB DEFAULT CHARSETutf8替换成ENGINEInnoDB DEFAULT CHARSETutf8mb4再执行基本能过。5.4 后端启动报错连接不上 MySQL现象执行python app.py后日志里出现Cant connect to MySQL server或Access denied for user rootlocalhost。原因配置文件里的数据库地址、用户名或密码跟你本机不一致。常见情况是配置文件写的是password: 123456你装 MySQL 时设的密码是root123连不上的原因就出在这。解决找到项目里的数据库配置文件通常是config.py或db.py把连接字符串改成自己本机的账号密码app.config[SQLALCHEMY_DATABASE_URI] mysqlpymysql://root:你的密码127.0.0.1:3306/travel_db?charsetutf8mb4这里root是用户名你的密码改成实际密码travel_db改成脚本建出来的数据库名。改完重启后端。另外确认 MySQL 服务已启动Windows 下可以在任务管理器「服务」页看 MySQL80 之类的服务是否在运行。5.5 前端能打开但接口请求全部失败登录都没反应现象管理后台首页正常显示但输入账号密码点登录一直转圈或提示网络错误浏览器 F12 里看到请求红色报错。原因前后端地址或端口不通。一种情况是后端端口是 5000前端代码里写的接口地址是http://localhost:5000没问题另一种情况是后端根本还没启动或者把端口写成了 8000。也有跨域问题前端在 8080 端口后端在 5000 端口跨域没处理浏览器默认拦截响应。解决先确认后端已启动访问http://127.0.0.1:5000/api/scenic/list能返回 JSON。能返回但前端请求失败就是跨域问题后端加 CORS 支持from flask_cors import CORS CORS(app)把这两行加在 Flask 实例初始化之后重启后端即可。6. 把推荐逻辑落到答辩从相似度计算到演示动线设计答辩环节最容易露怯的就是「智能推荐」四个字讲不实。面试老师或答辩评委通常会追问三连推荐算法具体是什么相似度怎么算推荐结果怎么生成的如果只能说「代码里有实现」会显得没有消化。下面这段代码是协同过滤推荐模块的核心计算拿到源码后对照着定位到自己的项目里逐行看懂。import numpy as np # 构建 用户-物品 评分矩阵 # 行索引为用户ID列索引为景点ID没有行为记0分 user_item_matrix [ [5, 0, 3, 0], [4, 0, 0, 2], [0, 3, 4, 5], [3, 4, 0, 1], ] def cosine_similarity(list_a, list_b): 计算两个景点的余弦相似度 dot_product np.dot(list_a, list_b) norm_a np.linalg.norm(list_a) norm_b np.linalg.norm(list_b) if norm_a 0 or norm_b 0: return 0 return dot_product / (norm_a * norm_b) # 计算景点之间的相似度矩阵 # item_matrix 的每一列为同一景点在不同用户下的评分 item_matrix np.array(user_item_matrix).T movie_count item_matrix.shape[0] similarity_matrix np.zeros((movie_count, movie_count)) for i in range(movie_count): for j in range(movie_count): similarity_matrix[i][j] cosine_similarity(item_matrix[i], item_matrix[j])cosine_similarity函数接收两个向量先算点积再除以模长乘积得到的值在 0 到 1 之间越接近 1 表示两个景点被同一批用户喜欢的程度越高。双层循环里逐个景点求相似度最终得到对称的相似度矩阵拿这个矩阵给目标用户推荐收藏景点最相似的 Top-N 个。毕设演示时建议按这条动线走管理员登录后台 → 添加几个新景点 → 切换到普通用户 → 浏览并收藏两个景点 → 回到推荐页看到相似景点推了回来。这条链路短、可视、逻辑完整评委能直观看到推荐系统从输入到输出的过程比对着代码讲更有说服力。演示前把账号密码和数据库状态确认好。我从那次 demo 翻车后养成了习惯每次演示前强制走一遍「重启 MySQL → 启动后端 → 打开前端 → 登录 → 收藏一个景点 → 查看推荐结果」的完整流程顺序一步不错。这份项目源码结构清晰适合在上面做二次开发希望能帮到你。另外提醒一点拿到压缩包先完整解压不要在压缩包内直接双击 .bat。有用户习惯用 WinRAR 的预览功能直接执行压缩包里的脚本结果脚本找不到当前目录下的依赖文件报No such file or directory。解压后建议把文件夹路径里的中文和空格去掉比如放到D:\travel_recommend某些 Python 包在带中文的路径下会出现编码异常这个细节能省掉一堆莫名其妙的问题。本文还有配套的精品资源点击获取