重写了一个校园微信公众号后端

2013 年，大二暑假。我第一次从零到一编写了一个 Web 应用，此前我都在运营维护 Discuz! 搭建的校园论坛、搭建过校园 PT 站，只懂 HTML 、 CSS 和 PHP 的一些皮毛：修改代码、保存、运行，看上去没问题，上线。当时没有深入学习编程，也没打算当程序员，只是周围没人懂开发，只能自己硬着头皮上。

后来看到某大学的校园公众号的新闻，兴奋得晚上睡不着觉，第二天起来找编程资料，花了一周把《 Learn Python the Hard Way 》连爬带滚过了一遍，然后就动手写了。当时什么都不懂，不懂就搜索，示例代码拷贝下来，改一改运行，可以用。没有明确的模块划分，也不懂什么框架 API ，反正 import 进去就能运行了。最终 App 的目录下面塞了 30 多个文件，代码复制粘贴，洋洋洒洒上千行， MysqL 语句也是一条一条在终端运行测试出来的，花了三四天没把部署环境搭建起来，于是就放到 SAE 上运行。

从暑假开始，陆续开发了录取查询、电影、天气、 SimSimi 、接入校园论坛数据、漂流瓶聊天、全校 40 多家外卖菜单、接入图书馆系统、快递查询、课表、成绩查询……加上运营的功夫，一个多学期，关注人数已经覆盖了三分之二的学生。

以上就是我编程入门的作品了。同学们看到微信里漂亮的排版，却不知道实现过程的龌蹉，但是谁的第一次不是这样呢，重要的是It Works!。后来我凭借大学的经历获得了一份 Python 的实习工作，误打误撞，最后成为了一个前端程序员。毕业之后，由于校园团队里没合适的人接手开发，功能就没继续维护更新了。到现在自己技术成长了许多，也为了方便师弟接手维护，于是就把公众号后端重写了。

以下是正文:)

主要技术栈：

Python 、 Flask 、 Redis 、 MySQL 、 Celery 。 结构很简单，处理微信请求的路由，判断用户指令，一系列功能模块，队列、定时任务，还有基础的 models 、 templates 、 utils 、 config 。

主要功能：

• 期末成绩查询
  • 手动查询
  • 微信分享成绩单
• 快递查询
  • 单号查询
  • 扫码查询
  • 包裹动态，自动提醒
• 校内图书馆图书搜索
  • 借书记录
  • 一键续借
  • 还书提醒
• 签到排行榜
• 机器人陪聊

一些细节：

• 字典、正则匹配指令，避免过多的条件语句嵌套。
• 场景状态，支持上下文回复。
• AES 算法加密保存敏感信息。
• 全局保存、统一刷新微信 access_token 。
• 将静态回复文案独立到配置文件，统一管理。
• 一切依赖外部 API 的操作都使用客服接口异步回复。因为微信服务器有 5 秒内回复的限制。
• 关键词指令优先于上下文状态。用户进入上下文状态后，任何关键词指令都可以跳出当前状态。
• 快捷菜单的操作都有对应的关键词，兼容繁体、全角空格。
• 回复消息中，长文本的回复使用图文信息进行排版。
• 前端 UI 使用 WeUI 统一风格，使用 CDN 加速。

功能预览：

除了主要的功能比较实用，其他小功能相对鸡肋，纯粹为了好玩。我认为程序员也应该关注产品体验的细节。所幸微信公众号开发几乎不涉及界面设计，界面上只要关注回复排版，比如文本的换、空行排版、<a>标签的使用。交互上要高效，尽量兼容用户的误输入。快递查询，可以扫快递单的条形码以及连续输入快递单号进行查询；成绩查询，绑定成功的同时就会发送消息给用户。

这次厚脸皮开源出来，就是想和大家交流学习，同时给需要的人一个参考。因为本职前端，上述一些 Python 类库的使用，都是边查文档边写的， Python 也是懂基本语法的水平，测试还没写……如果发现代码中出现低级的写法或者错误，恳请指正。关于微信公众号开发的，也欢迎交流。

GitHub 地址，欢迎 star & fork ： https://github.com/paicha/gxgk-wechat-server