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