Node.js+微信小程序实战：厦门周边游平台开发全记录

最近用nodejs加微信小程序做了一款厦门周边游平台，从后端接口到小程序前端，再到上线发布，整个过程踩了不少坑。这个项目最大的价值不在于“又做了一个旅游App”，而在于它把厦门本地化的周边游信息和微信生态的便捷入口结合在了一起，游客不用下载App，扫码就能用，本地人也能快速找到周末去处。如果你是刚接触微信小程序开发，或者正在用nodejs写后端接口，又或者想做一个带真实业务的小程序练手，这篇内容应该能帮你省下不少时间。

我尽量把开发过程中的真实决策、代码细节、故障排查都写出来，而不是只给一个“项目展示”。文章里没有那些绕来绕去的理论，全是实际动手时用得上的东西。

1. 项目定位与整体设计思路

1.1 项目背景：为什么做厦门周边游平台

做这个项目之前，我观察到一个很明显的需求分化。外地游客来厦门，目标很集中，就是鼓浪屿、南普陀、环岛路、曾厝垵这些老牌景点。但厦门本地人和周边城市的游客，周末更想去的是同安的汀溪、翔安的香山、海沧的大屏山，或者漳州、泉州这种一两小时车程内的目的地。这些地方的交通怎么走、有什么特色民宿、哪家海鲜排档靠谱，信息非常分散，大多数只能靠小红书或者本地群打听。

厦门周边游平台就是想把这部分需求收拢到一个微信小程序里。用户打开小程序，先看他所在的位置，然后推荐附近的一日游路线、半日游路线，按季节推送采摘、露营、赶海这类主题玩法。后端用nodejs做接口，前端用微信小程序做载体，好处是免安装、传播快，分享给朋友一个卡片就能打开。整个项目定位是一个轻量级的周边游信息服务平台，先不做复杂的支付和订单流程，重点把内容展示和路线推荐做好，后期可以再加民宿预订和门票购买。

1.2 核心功能拆解与用户角色

我按用户角色把功能分成了三类。游客端主要看：景点列表、景点详情、路线推荐、美食推荐、民宿展示、攻略文章。注册用户还能做收藏、点赞、评论，以及生成自己的游玩计划。运营后台的功能我一开始没有单独做网页，而是直接在小程序里放了几个管理入口，方便自己添加和更新内容，后来才拆出了一个简单的web管理端。

具体功能清单大概是这样的：

• 景点浏览：按区域、标签、热度筛选，支持关键词搜索
• 路线推荐：根据用户选择的天数、出发地点、偏好主题，生成推荐路线
• 内容展示：景点介绍、门票参考价、开放时间、交通指引，都用富文本图片展示
• 用户中心：微信授权登录、我的收藏、我的足迹、我的评论
• 信息发布：管理员可以发布景点、编辑路线、更新攻略

整个项目大概花了三周时间，前端小程序和后端接口同步开发。最开始的版本没有做数据库，而是用json文件模拟数据，先把页面和交互跑通，后来才切换成MySQL。这个做法我建议你也试试，特别是时间紧张的时候，先把核心流程打通，比一上来就设计五张表要高效得多。

1.3 技术选型：为什么选nodejs + 微信小程序

很多人问我，后端为什么不用Java或者Python？其实在这个项目场景下，nodejs有几个天然优势。第一，前端是微信小程序，用的JavaScript，后端如果也用JavaScript，很多数据结构和逻辑都可以复用，比如日期格式化、数组处理、对象深拷贝这类工具函数，我直接在前端和后端各写了一份，思路完全一样。第二，nodejs的启动速度很快，在小团队开发、快速迭代的场景下非常合适，改完代码重启一下，几秒钟就能看到效果。第三，nodejs生态里有很多现成的库，做接口用Express或者Koa，做数据库操作有Sequelize或者Prisma，文件上传、定时任务、邮件发送都有成熟的包。

微信小程序这边，我选的是原生开发，没有用uni-app或者Taro。原因是这个项目需要用到地图、定位、转发分享这些原生能力，原生小程序对这些组件的支持最直接，文档也最全。如果你要同时跑微信和支付宝两个平台，那用uni-app是合理的，但我的目标用户就在微信里，没必要多引入一层框架。另外，原生小程序的体积控制也更好，首屏加载会快一些。

2. Nodejs后端环境搭建与接口开发

2.1 Nodejs安装与环境变量配置

这个项目一开始就卡在了环境安装上。我当时下载的是nodejs官方网站的LTS版本，版本号是18.x。安装包一路下一步就行，但有一点要特别注意：安装路径不要带空格和中文。我看到很多教程喜欢把nodejs装在D:\Program Files (x86)这种目录里，后面很容易出现权限问题，尤其是npm全局安装包的时候，可能会因为权限不足导致各种奇怪的报错。我自己后来统一装在D:\nodejs或者C:\nodejs这种简单路径下。

安装完成后，打开命令行，输入node -v和npm -v验证，如果能看到版本号就说明装好了。nodejs安装包默认会把node和npm的路径写入系统环境变量，正常情况下不需要手动配置。但如果你用的是zip绿色版，那就要手动把解压目录加到PATH环境变量里。配置完之后，最好重启一下命令行终端，不然环境变量不会生效。

2.2 npm命令执行报错：npm.ps1无法加载的修复

我相信只要你在Windows上用过nodejs，大概率遇到过这个报错：

bash复制npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上