麻将小程序搭建教程：2026年新手从创建项目到提交审核的完整步骤

老家开棋牌室的表叔问过，朋友圈做私域社群的运营找过，甚至前阵子一个开茶馆的大学同学也跑来问我：“我不需要真人在线打牌那种复杂的，就做一个记分用的，或者朋友之间约局用的小工具，能搞不？”

我的回答一直是：能搞，2026年更容易了。

但问题是，大部分人一搜“麻将小程序搭建教程”，要么跳出的是四五年前的过时视频，要么是卖源码的广告帖，真正把每一步拆开讲、让新手能跟着做出来的内容太少了。

今天这篇文章，我就拿自己最近帮朋友搭的一个麻将记分小程序当案例，从创建项目到提交审核，把完整流程给你捋一遍。看完你就知道——这事儿没你想的那么玄乎。

一、动手之前，先把“能不能做”这件事讲清楚

很多新手最纠结的问题不是怎么写代码，而是“麻将类小程序到底能不能上线？”

这个问题得分两层来回答。

第一层：政策上有没有问题？

微信官方对棋牌类小程序的审核一直比较严格，但不是一刀切。关键在于你的小程序“玩不玩钱”。

如果你做的是麻将记分工具、朋友约局辅助、牌谱记录学习这类纯工具型产品，不带任何虚拟币充值、积分兑换、现金提现功能，审核通过率是完全OK的。我自己经手过一个四川麻将牌型查询的小工具，类目选“工具→信息查询”，一次审核就过了。

但如果你打算做线上匹配对战的麻将游戏，涉及随机配对、输赢排行、虚拟筹码，那就需要“文娱→游戏”类目，这个类目对个人开发者基本不开放，必须有企业主体和游戏版号。门槛一下子就上去了。

第二层：技术上有门槛吗？

2026年微信云开发的成熟度，已经让数据存储和实时同步变得非常简单。一个基础的麻将记分小程序，核心就是把每局输赢数据存到云数据库里，然后在前端做统计展示。这类功能的代码量，有经验的开发者一天就能写完，纯新手跟着教程走，一周左右也能搞定。

所以结论很明确：只要定位是工具辅助，不走真人对战和付费博弈路线，麻将小程序不仅能做，而且适合新手练手。

二、第一步：注册账号并选对类目

跟所有小程序一样，第一步先去微信公众平台注册账号，拿到AppID。这个流程我上一篇文章详细讲过，不再赘述。这里重点提醒一件事：类目必须在开发之前就定好，不要等写完了再去选，选错了返工成本很高。

对于麻将类工具小程序，推荐的服务类目有以下几种（根据实际情况选）：

工具 → 信息查询：适合做麻将规则查询、牌谱记录、番型计算器这类纯工具。

体育 → 棋牌：如果你的小程序定位于线下棋牌赛事辅助，比如比赛记分、对手战绩统计，可以走这条路，但需要提供相关资质或说明文档。

社交 → 社区/论坛：如果你做的是麻将爱好者交流社区，用户发帖讨论战术心得，选这个类目比较稳妥。

一个特别重要的提醒：千万、绝对不要选“游戏”或“文娱”相关类目，除非你手上有完整的游戏版号和经营许可。一旦选了这个方向，审核流程会骤然升级，个人开发者基本走不通。选工具类目才是安全通道。

三、第二步：搭建牌桌界面——核心页面的布局思路

麻将小程序最核心的页面是什么？一个牌桌记分界面。我们以四人麻将记分为例，界面大致长这样：中间是一个四人麻将桌的俯视示意图，四个方位各显示一位玩家的昵称、头像和当前得分，底部是操作区——输入胡牌类型、翻数、赢家，点确认后自动计算并更新分数。

这个页面的wxml结构可以拆成三块：

顶部信息栏：显示当前圈风、局数和庄家标识。

中部四人记分区：一个相对定位的容器，四个玩家模块用绝对定位放在上下左右四个位置。

底部操作区：放记分按钮和分数输入控件。

wxss布局上，四人定位的核心是用 position: relative 的父容器配合四个 position: absolute 的子模块。具体位置数据我直接给出来供你复制参考——上方位玩家用 top: 0; left: 50%; transform: translateX(-50%) 固定在中央上方，下方位玩家用 bottom: 0; left: 50%; transform: translateX(-50%) 固定在下方，左方位玩家用 left: 10%; top: 50%; transform: translateY(-50%) 定在左侧，右方位玩家用 right: 10%; top: 50%; transform: translateY(-50%) 定在右侧。容器整体高度约550rpx，四个位置刚好形成一个菱形布局，视觉上就是一张方桌。

四、记分逻辑怎么写——把麻将规则翻译成代码

麻将记分的核心逻辑其实就是一个条件判断的嵌套。不同的胡牌类型对应不同的计分规则，我们拿四川麻将常见的“血战到底”规则举例：

假设基础分为1分（可配置），那么：

自摸：赢家得3分（三家各输1分）

点炮：赢家得2分（放炮者输2分，其余两家不输不赢）

杠上开花：在自摸基础上额外加1分，赢家得4分

抢杠：在点炮基础上额外加1分，赢家得3分

翻译成代码，在page的js文件里可以这样写：

// 记分核心函数
recordScore(winType, winner, loser) {
const baseScore = this.data.baseScore; // 基础分，默认1
let scoreMap = {0: 0, 1: 0, 2: 0, 3: 0}; // 四位玩家的分数变动

switch(winType) {
case 'selfDraw': // 自摸
scoreMap[winner] = baseScore * 3;
[0,1,2,3].forEach(i => {
if(i !== winner) scoreMap[i] = -baseScore;
});
break;
case 'discardWin': // 点炮
scoreMap[winner] = baseScore * 2;
scoreMap[loser] = -baseScore * 2;
break;
case 'kongBloom': // 杠上开花
scoreMap[winner] = baseScore * 4;
[0,1,2,3].forEach(i => {
if(i !== winner) scoreMap[i] = -(baseScore + 1);
});
break;
// 更多胡牌类型继续扩展...
}
// 把分数变动更新到云数据库
this.updateScores(scoreMap);
}

这里只是给出了框架逻辑，实际项目中你还需要加上“一炮多响”“流局查叫”等边缘情况处理。不过新手阶段不用想那么全，先把核心记分跑通，边缘场景在实战中逐步补，这个开发策略远比追求一步到位要高效。

五、数据存储——用云开发搞定多人数据同步

麻将记分有个特点是数据需要多端同步——A玩家记了一笔分数，B玩家的手机上也应该马上看到更新。

这个需求如果自己搭服务器处理WebSocket长连接，新手基本搞不定。但用微信云开发就简单很多，核心思路是：数据统一存在云数据库里，每个玩家页面展示的数据都从同一个数据源读取，通过定时轮询或数据库监听来实现准实时更新。

具体做法分三步：

第一步，在云开发控制台新建一个集合（collection），比如叫 game_records，每条记录存这些字段：

{
"roomId": "房间号",
"round": 3,
"winType": "selfDraw",
"winner": "playerA",
"loser": null,
"scoreChange": { "playerA": 3, "playerB": -1, "playerC": -1, "playerD": -1 },
"createTime": "2026-03-15T14:30:00Z"
}

第二步，记分的时候调用云函数写入记录，同时更新一个 room_scores 集合里的总分数据。

第三步，每个玩家的页面每隔3-5秒请求一次 room_scores 集合的最新数据，刷新显示。3秒的延迟在牌桌上完全可接受，毕竟现实中算分也得花几十秒。

如果你想更进一步优化，微信云开发其实已经支持数据库实时推送能力（watch监听），数据一变化就主动推送给所有在线客户端，连轮询都省了。这一块稍微进阶一点，但你做到这一步之后自己查文档就能搞定，我这里不展开。

六、组件化开发——把记分面板做成可复用的

写到这你可能会问：如果我以后要做其他棋牌类工具，记分逻辑能不能通用？

当然能，而且推荐从一开始就把它抽象成自定义组件。

在小程序里创建自定义组件很简单，在项目根目录新建一个 components 文件夹，然后右键“新建 Component”，微信开发者工具会自动生成组件所需的四个文件。

一个通用的记分组件，只需要暴露几个属性：

在wxml里引用时，只需要写一行：

<score-panel players="{{playerList}}" baseScore="{{1}}" bind:scorechange="onScoreChange"></score-panel>

组件内部封装了全部记分逻辑和UI，外部页面只需要监听 scorechange 事件拿到结果数据去更新数据库就行。这样一来，你辛辛苦苦写的记分模块，下次做斗地主记分、扑克记分，直接换个配置参数就能复用，不用重写一遍。

七、提交审核前的自检清单

功能开发完成、本地测试跑通之后，先别急着点“提交审核”。麻将类小程序的审核眼比其他类目更严格，提交前有几件事必须逐项检查：

类目正确性：再次确认服务类目选的是工具或体育类，没有误选游戏/文娱。

无支付敏感词：小程序内任何地方都不能出现“充值”“提现”“现金”“赌”等字眼。就算你只是记个分，也别在文案里写“一局赢了多少元”，改为“一局得分+3”。

页面完整度：审核人员会逐页检查，首页不能一片空白，至少要有清晰的功能入口和操作说明。

隐私合规：如果涉及用户头像昵称展示，必须在首次使用时弹出授权弹窗，不能强制获取。

名称合规：小程序名称里不要带“麻将”“赌”“博”等敏感字眼。可以换个思路，叫“牌局助手”“四方记分”“桌上账本”这类名字，既有关联性又不踩红线。

正常审核周期1到7个工作日，工具类目通过率会高一些。如果被打回也别慌，审核人员会给出具体的驳回原因，对照修改后重新提交就行。一般打回一两次很正常，只要不是类目选错那种硬伤，都能改回来。

我一直觉得，麻将类工具小程序其实是个被低估的方向。全国打麻将的人数以亿计，线下棋牌室、社区活动室、朋友聚会，有大量“记分算账”这种最朴实的需求，而市面上好用的工具远没到饱和。不需要高并发、不需要复杂算法、不需要烧钱推广，一个小工具做好就能服务一群人。

如果你看到这，正好手上有想法但不知道从哪下手，或者已经有现成的麻将小程序源码但不懂怎么部署上线，可以在文章下方扫二维码加我微信聊聊。我看到消息都会回复，帮你把第一步迈出去。

扫描下方二维码，备注“麻将”即可添加我的微信。