“你附近有什么好吃的”这个问题,我每次到一个新城市都会被问住。大众点评上收录的店偏连锁化,小红书推荐的又太散,真正好吃的东西往往只存在于本地人的口中和记忆里,且没有一个人能给出一个带位置、带评价、带真实用户反馈的本地美食地图。这个项目就是为解决这个问题做的——一个基于 Node.js + Vue + ElementUI 的美食小吃分享系统,后端用 Express + MySQL,地图部分接入第三方地图 SDK,最终把分散在小巷子里的美食,用一张“用户自发标注的美食地图”串起来。
如果你正在找全栈练手项目,或者需要一套完整可跑通的毕业设计,这篇文章的思路完全可以复刻。我会从项目定位讲到环境搭建、数据库设计、后端接口、前端页面、联调部署,把每一步的关键逻辑和踩过的坑都写出来。就算你目前只懂 Vue 基础或者只写过简单 Node 接口,跟着这套流程也能把一个完整项目跑起来。
1. 项目定位:不是“增删改查”,是一张由用户共同维护的美食地图
1.1 这个系统到底解决了什么
市面上做美食推荐的平台很多,但大多有一个通病:数据来自商家入驻或编辑人工录入,真正的本地小店、街边摊、隐藏吃法很难被收录。而 UGC(用户生成内容)模式天然适合解决这个问题——让每个用户把自己发现的小吃分享出来,标注位置、上传图片、写推荐理由,其他人就能按图索骥。
这个项目把“分享”和“地图”绑定得很紧,用户看到的不是一张普通列表,而是一张带标记点的地图。这种设计有三个好处:
- 位置信息直观,用户一眼就知道哪个小吃离自己近。
- 数据越用越有价值,用户分享得越多,这张地图就越接近真实的“本地美食指南”。
- 技术上有足够的复杂度,能覆盖一个完整全栈项目的所有关键环节:用户认证、文件上传、地图交互、附近搜索、分页、评论、收藏等。
1.2 为什么是这套技术栈
很多人会问,做这种系统用 Java + Spring Boot 会不会更好?我的回答是:Java 生态没问题,但对个人项目来说太重了。Node.js + Express 的优势在于,前后端都是 JavaScript,你只需要掌握一门语言就能写完整个项目,排错时也能在前端 console 和后端 log 之间快速切换思路。
MySQL 则是“稳”字当头。美食信息的数据结构非常固定(标题、分类、经纬度、地址、封面图),是典型的二维表结构,用关系型数据库再合适不过。而且 MySQL 的资料和踩坑帖远比 MongoDB 多,真出问题你大概率能搜到现成解决方案。
前端选 Vue + ElementUI,核心原因是开发效率高。ElementUI 的好处是组件足够多,表格、弹窗、表单、分页、下拉多选开箱即用,平台型的后台管理系统里,你几乎不需要自己手写复杂交互组件。地图用腾讯地图 JavaScript SDK,因为这个项目里要展示标记点、拾取坐标、做信息窗口,腾讯地图这些能力都现成,而且申请 key 免费,对学习项目没资金压力。
需要提醒一下版本问题:如果你的项目从零起步,且没有旧代码包袱,建议用 Vue 3 + Element Plus;如果参考资料、课程要求或已有代码基于 Vue 2 + ElementUI,那也完全够用。本文里的地图集成、分页、弹窗拖拽等思路,在 Vue 2 和 Vue 3 下都是通用的。
1.3 功能模块划分
- 用户模块:注册、登录、个人信息。
- 美食分享模块:发布小吃(含地图选点)、图文信息、分类选择。
- 地图展示模块:地图标记、信息窗口、附近美食查询。
- 互动模块:评论、收藏。
- 列表与筛选模块:分页、关键词搜索、分类筛选。
这套功能设计完后,前后端的开发量大概是:后端接口约 15 个,前端页面约 8 个,不算多,但对入门者来说,每块都是实打实的锻炼。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境搭建:最容易劝退新手的三个环节
2.1 Node.js 安装与环境变量:LTS 版本是最优选
Node.js 的安装本身不难,去官网下载 LTS 版本的安装包就行,但很多人在第一步就卡住了。所谓 LTS(Long Term Support)是长期维护版本,稳定性优先,适合绝大多数项目;Current 版本虽然新,但可能有兼容性问题。学习项目直接选 LTS。
环境变量的配置在一些系统上可能已经被安装包自动处理了,但建议你装完手动验证一下。打开终端,输入:
bash复制node -v
npm -v
能输出版本号就说明环境没问题。如果提示“node 不是内部或外部命令”,那通常是 PATH 里没有加 Node.js 的安装目录,常见路径是 C:\Program Files\nodejs\,把它加到系统环境变量的 Path 里即可。
另外提一个很多人忽略的点:Node.js 的版本会影响部分依赖的安装。比如某些旧版 Express 或构建工具在新 Node 版本下可能报错。我自己的习惯是先用 nvm(Node Version Manager)管理版本,安装一个 LTS 版本,既避免版本混乱,以后切换也方便。
2.2 npm.ps1 无法加载的两种解法
这个报错是 Windows 用户在 PowerShell 里运行 npm -v 或 npm install 时经常碰到的:
code复制npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1,因为在此系统上禁止运行脚本
原因不是 npm 坏了,而是 PowerShell 的脚本执行策略默认是 Restricted,禁止任何脚本运行,npm.ps1 本质上是一个 PowerShell 脚本,所以被拦住了。解决方案有两个:
方案一:以管理员身份打开 PowerShell,执行:
powershell复制Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
输入 Y 确认后,再运行 npm 命令就正常了。作用范围是当前用户的 PowerShell,限制是只允许本机脚本和经过签名的远程脚本,安全性可控。
方案二:如果不方便改动执行策略,就直接用 CMD 或 Git Bash 代替 PowerShell,npm 在 cmd 里没问题。
这两个方案我都试过,推荐方案一,一劳永逸,因为后续 npm 的很多全局命令(eg. vue create)在 PowerShell 里也会用到。
2.3 MySQL 8.x 的安装与初始化
MySQL 安装版本很多,建议用 MySQL Installer 装 8.x。安装时有两个关键点:
- root 密码设置后要记牢,后续连接数据库都会用到。
- 字符集选择 utf8mb4。如果安装时忘了,可
