How to Build a WeChat Mini Program with WorkBuddy: A Beginner's Guide

@songsong
簡體中文2026年8月07日
162K
750
156
30
1.3K

TL;DR

This guide demonstrates how to use WorkBuddy AI to build WeChat Mini Programs from scratch, including code generation, debugging, and cloud deployment for non-coders.

想做个微信小程序,你可能会先被一堆东西拦住:微信开发者工具、项目目录、AppID、云开发环境、数据库、上传、后台版本管理。

这都是啥啊,一行代码还没写呢。就给我整这些有的没的,然后就卡在这儿了。

没关系,没写过代码、没做过小程序、连 AppID 是啥都不知道,这篇就是写给你的。

一个下午就能做出来,是种怎样的体验

看完这篇,这些你就全会了:

  • 把代码导进微信开发者工具(AppID 都不用先注册
  • 在自己手机上打开它
  • 出个二维码,发给朋友试
  • 提审、上线、被人搜到

先看我的成品。

宋宋 - inline image

怎么样,感觉还行吧,那咱话不多说,开整。

一、开工前的十分钟

打开workbuddy,在专家、技能、连接器那一栏里找到微信小程序开发者这个专家,把它召唤出来。

宋宋 - inline image

然后,别说"帮我做一个小程序

text
1我想做一个自己使用的每日习惯打卡的小程序,
2第一步,我需要跟你沟通什么内容?先不要写代码,我们先讨论一下。

把"每日习惯打卡"换成你自己的。

然后它会问你,你的数据想怎么存、第一版功能想做到多完整、打算用什么方式开发这个小程序、需要每天打卡提醒么、习惯类型是什么样的、打卡提醒的时间粒度是什么样的、界面视觉风格偏好,最后还会问你 针对分类维度、归档删除和统计周期再进行微调。

这些你之前都没想到的问题,它都帮你一一想好,然后定好方向。

先不用大而全,先让它把1.0版本先搭起来,然后有了基础框架,我们就可以慢慢调整,修修改改。然后方向等内容都定好了就让它开干。

然后在它写代码的这段时间,你可以先去装微信开发者工具。

微信官方出的,因为你的小程序最后要在它里面跑、预览、上传。搜"微信开发者工具"进官方下载页,选稳定版,一路下一步,装完扫码登录。一进去就是这样的。

宋宋 - inline image

有几点要注意:

💡 第一次做,功能就留一两个。 功能越多,要生成的页面越多,冒出来的报错也越多,每个都得你自己复现一遍、描述给它听。所以先把核心搞定,再说其他的。

💡 模型换成 HY3,别挂着 auto。 它现在限时免费,无限畅饮。(限时活动,你看到这篇的时候先去后台瞄一眼还在不在。)

⚠️ 菜单名跟我说的对不上,是常事。 这类软件更新太勤。有问题直接把截图丢给workbuddy,它告诉你点哪儿。

代码写完,它给你一个项目文件夹的地址,一般是软件按时间建的目录,末尾是你这个项目的名字。对这个地址有个印象,下一步要用到。 它通常还会顺手给你一段导入指引,没给就直接问:"代码写好了,我怎么把它导进微信开发者工具?"

这时候,你手上有:一整套小程序代码,和一个装好的微信开发者工具。

东西都齐了。要测试预览看看半成品了。

二、来看半成品

打开刚下好的微信开发者工具,扫码登录之后,直接点击 +。

然后填写这三个:

  1. 项目名称:随便起,你自己认得就行。
  2. 目录:粘贴上一步那个地址。
  3. AppID:红色,没关系,点击测试号,丝滑继续
宋宋 - inline image

后端服务 先点选不使用云服务。填完点创建,再点信任并运行,工具会自己开始构建。

⚠️ 什么时候必须换正式 AppID:如果要使用微信云开发,想上传,其他人可以体验的,就用邮箱注册一个免费的。 本文第六章会详细讲。

⚠️ 另外,注册前先想清楚你要做哪一类。有小游戏和其他,选择了就不能改了,所以要选择前要仔细想清楚。

顺利的话,构建完你就能在工具里看见自己的小程序了,左边是模拟器,右边是代码。

这时候,你手上有:一个能在电脑上跑起来的小程序。

也可能你看见的是满屏红字。别慌,好修。

三、满屏红字,谁写的谁修

第一次构建出一堆红字,正常。

处理办法就一句话:谁写的谁修。😂

具体动作是这样:

  1. 在微信开发者工具里找到调试器面板,红色的报错都在里面。
  2. 把报错内容整段复制,别只截一半,也别自己转述。
  3. 发给workbuddy ,啥都不用说,它看完直接帮你修好

它分析完,如果它能修的直接修好,需要你去设置的 就会引导你需要做什么,很简单。

不过有两点要注意:

⚠️ 有一类"错"不算错:小程序不支持一部分网页写法。比如某些选择器、鼠标悬停效果,在电脑上看着不对劲,是因为小程序压根就不支持。这种直接跟它说"这个效果小程序不支持,换一种实现"。

⚠️ 还有一类是假错:改完不生效。先别怀疑它,在工具的右上角普通编译旁边有个 刷新的按钮点一下编译强制刷新,八成就好了。

这时候,你手上有:一个不再白屏、无问题丝滑的小程序。

电脑上看着挺美。模拟器上点得动,但是真机上未必。

四、你在电脑上看着挺好,手机上可能不一定

小程序在电脑模拟器里跑得顺,到手机上样式错位、按钮点不动,是常事。屏幕尺寸不一样,触摸和鼠标也是两码事。

把它弄到手机上,就点一个按钮:预览。

宋宋 - inline image

工具会生成一个二维码,你用手机微信扫,你的小程序就在手机上打开了。

这儿最容易搞混:预览、真机测试、远程调试,这三个都能给你弹个二维码出来,到底有啥区别呢?

你点的

你得到什么

什么时候用

预览

手机上直接打开,看效果最快

平时改一版看一眼,用这个

真机测试

手机上跑完整流程,还能选安卓或者 iOS

想知道两种手机上表现一不一样,用这个

远程调试

手机上跑,同时电脑上能看到日志

手机上出了 bug 但电脑上复现不了,用这个

⚠️ 别拿预览当测试用。预览是给你自己大致看看效果的,看着没问题不代表跑得通。确认还是要走真机测试。

⚠️ 还有一条:为了方便调试开发阶段工具里有些校验是关着的,但真机上该校验的还是照样校验。所以有的时候电脑上没事、手机上一堆问题。

这时候,你手上有:一个在你自己手机上能打开的小程序。

手痒了吧,是不是想立马甩个码给朋友。稍等,还得跑五件事,要不可能全是bug😂。

五、别让朋友帮你测 bug

五分钟的事,自己先跑这五项:

  1. 添加:加一条新的,能不能出现在列表里。
  2. 状态:切换完成和未完成,切得动吗。
  3. 重进退出小程序再重新打开,你刚才加的东西还在吗。
  4. 删除:删掉一条,刷新之后它有没有又冒出来。
  5. 空值什么都不填直接点添加,它应该给你个提示,而且不能产生一条空记录。

第三项和第五项不专门去试就会漏。

修完任何一项,五项全部重跑一遍,别只补测你刚修的那一项。改 A 弄坏 B 是常态。

⚠️ 五项都过了,也只说明它不会当场崩。但是这个过程也是打磨的过程,总能发现奇奇怪怪的问题,然后自己又灵光乍现,这里加一个新奇功能,又会发现这里颜色不对了,那里按钮错位了,总之这里可能会耗上一段时间,最终都是为了呈现一个 自己满意的版本。

这时候,你手上有:一个自己验过、打磨过满意的小程序。

东西打磨得差不多了。想发给朋友,还差最后一样:正式身份。

六、发个码,给朋友扫

想让别人扫,你得先有个正式的 AppID。怎么注册呢:

  1. 打开微信公众平台,走注册流程。 账号类型有好几种,公众号、小程序、小游戏都在那儿,认准小程序那个。⚠️ 选错了改不了,只能注销重来,看清楚再点。
  2. 填一个干净的邮箱。 填上邮箱然后点击右边激活邮箱。会给你邮箱发验证码,输入验证码,在填上你的密码 进行注册。
宋宋 - inline image
  1. 选主体。 自己玩就选个人,身份证实名加微信扫码验证,不花钱。
  2. 进后台,在开发管理里找到 AppID,一串 wx 开头的,复制出来。
宋宋 - inline image

拿到 AppID,直接把这句话发给你的 workbuddy:

text
1把项目里的 AppID 改成我的 AppID:wx开头那一串

然后回到微信开发者工具,右上角点上传。

宋宋 - inline image

它会让你填版本号和备注。第一次就写 0.0.1,备注随便写点你自己看得懂的。上传完,去微信公众平台的版本管理页,你会看到刚传上去的那个版本,然后点向下箭头 里面有体验版,因为我这里已经点过了 就变成了取消体验,点击了成了体验版后 会给你个体验版的二维码

宋宋 - inline image

这时候就可以发给朋友们炫耀你的小程序啦。他扫了就能用,不需要你上架,也不需要过审核。

两件事要注意:

第一,上传不等于发布。 上传成功只代表开发版本已经进了后台,还没有正式发布。你的小程序现在搜不到,只有拿到码的人能进。

第二,体验版有期限。 一般是七天。过期了重新上传一版,再出一个码就行。所以它适合给几个朋友试试、适合拿去给人演示。

⚠️ 很多人到这儿就够了。 自己用、发几个朋友试试,体验版够使,七天一换而已,认证备案我后面章节再详细讲。

这时候你手上有:一个能发给朋友扫的体验版二维码。

到这儿,你已经做出一个真的小程序了。

朋友扫了码,进去玩了两下,加了几条东西。等他一关小程序,全没了。怎么让数据存下来呢

七、关掉也不丢

走到这儿,有件事一直没解决:你的数据,到底存在哪。

打卡记录也好,清单内容也好,只存在手机本地的话,换个手机就没了,也没法两个人一起用。要存数据,需要有后端。

自己搭后端意味着什么?后端接口、数据库、服务器部署、域名、HTTPS,还有小程序后台的合法域名配置,六样,一样都不能少,而且域名还得是备案过的。咱不整这些麻烦的,直接走云开发。数据库和后端逻辑都放在云上,小程序直接调,上面那些你不用操心。

  1. 工具顶部点「云开发」→ 开通 → 记下环境 ID

点击开通,它先会弹一个支付19.9每个月,等一下,它会自动引导跳到免费开发环境

宋宋 - inline image
  1. 复制这个环境ID 直接发给workbuddy 让他帮你设置globalData.env的环境ID即可。
宋宋 - inline image
  1. 云开发控制台 → 数据库 → 新建三个合 categories / habits / checkins,权限都设为「仅创建者可读写」。这几个集合 ,可以根据workbuddy给你生成对应的来创建,它会告诉你要创建那几个集合。
宋宋 - inline image
  1. 右键 cloudfunctions/login → 上传并部署:云端安装依赖。这里是回到你的微信开发工具里的工程文件里。

这里解决的就是:让云函数能找到它需要的第三方包,否则云端一运行就崩。

宋宋 - inline image

一个坑点:如果你在你的项目文件里没有找到cloudfunctions ,可能你的导入项目文件夹不对,找到你之前导入的文件夹地址,改成更上一层的文件夹即可

然后 数据落地准备好了,重新加载工程,但它会问你要两个东西,小程序 AppID 和云开发环境 ID

⚠️ 走这条路就用不了测试号了,AppID 必须是正式的。上面已经教大家怎样获取了。

⚠️ 云开发对新用户有时候有优惠活动。但是有时效性,有时有,有时没有。

然后重新导入你要存数据版本的小程序项目,APPID 你把你的帖过来,后端服务选择 微信云开发。

这样,数据就通了。

宋宋 - inline image

存数据,搞定了。如果让别人搜到你或者商用,下面挑战才刚开始。

八、让陌生人也能搜到你

体验版能跑,跟能过审是两码事。

先过六条自查

  1. AppID 换成正式的了吗。 测试号上不了架。
  2. 每个页面都点一遍,别有白屏,别有点了就崩的地方。
  3. 服务器域名配了吗。 你的小程序要是会去外面取数据,那些地址得先在小程序后台配上,位置是 开发 → 开发设置 → 服务器域名,按接口分四类填:request、socket、uploadFile、downloadFile。只认 https 和 wss,而且域名必须已经备案。 另外填 IP 不行,只填个父域名也不行。
  4. 把开发者工具里那个"开发环境不校验请求域名、TLS 版本及 HTTPS 证书"的勾取消掉。 它只在开发者工具和调试模式的手机上管用,真机非调试模式照样校验。域名配好了就关掉,关掉之后各端再跑一遍确认。
  5. 碰用户信息的,把用户隐私保护指引填了。 注意是"碰"才要:你的小程序要是会读头像昵称、位置、通讯录这类东西,就得在小程序后台的用户隐私保护指引里声明清楚。没声明的那些接口会被直接禁用,压根调不起来。 纯本地记事、一点用户信息都不碰的,这条跳过。
  6. 名称、头像、简介、类目在后台填完整。 类目选错是常见的退回理由。

💡 走云开发、或者压根不联网的,第 3 条和第 4 条跳过。

🔴 我给你整理好了 ,直接把下面这段甩给 workbuddy即可:

text
1我要提交微信小程序审核,帮我按下面几条逐条检查这个项目。
2能你自己改的直接改,改不了的告诉我去哪儿填什么。project.config.json 里的 appid,现在填的是不是测试号。
3列出 app.json 里所有页面路径,做成一张清单,
4我照着一个个点开看有没有白屏。
5全项目搜 wx.request、wx.uploadFile、wx.downloadFile、
6wx.connectSocket,把里面出现的域名全提出来,
7按这四类分组列成表,标出哪些不是 https 或 wss 开头、
8哪些填的是 IP。这张表我拿去后台配服务器域名。
9project.config.json 里的 urlCheck,如果是 false 就改成 true,改完告诉我。
10
11全项目搜用户信息类接口,头像昵称、位置、通讯录、相册、
12麦克风、剪贴板这些,列出用到了哪几个、分别在哪个文件哪一行。
13这张表我拿去后台填用户隐私保护指引。
14代码里还有没有调试用的 console.log 没清掉。
15最后出一张总表,一行一条,三列:检查项、现在什么情况、
16我下一步要做什么。你自己改掉的写"已改",
17要我去微信后台手填的写清楚填什么,查不出来的写"查不到",不许猜,也不许拿常识补。

⚠️ 第 2 条别糊弄。 官方明确要求提交的得是个完整成品,测试版、带着严重 bug 的版本会被打回。被拒理由里最冤的就是"页面空白或者功能不完整",审核要求还是挺严的。

然后就是提交审核前的 4 道门槛

宋宋 - inline image

1️⃣ 小程序信息(点 去填写)

这个最基础,必须填:

  • 名称:建议起个有辨识度的,比如「习惯打卡」「微习惯打卡」「每日打卡」之类的(个人主体不能含"微信/官方"等字眼,2-30个字符)
  • 图标:正方形,选一个 1024×1024 PNG,圆角或圆形都行
  • 简介:一句话说明功能,比如「每日微习惯打卡,记录成长每一天」
  • 服务范围:选「工具 > 效率」或「生活服务 > 生活助手」

2️⃣ 小程序类目(点 去补充 )

个人主体的类目选择比较受限,推荐路径:

  • 一级类目:工具
  • 二级类目:效率 或 记事本

如果工具类下没有合适的,也可以试 生活服务 > 生活助手。类目决定了你能用什么 API,打卡类小程序一般走「工具-效率」没问题。

3️⃣ 小程序备案

2024年起微信要求小程序必须做 ICP 备案才能发布。流程:

  • 填完上面「信息」和「类目」后这里才解锁
  • 个人主体备案需要:身份证正面照 + 人脸核验
  • 一般 1-3 个工作日出结果
  • ⚠️ 不备案 = 不能发布上线

4️⃣ 微信认证(可选,但强烈建议做)

不认证

认证后

被搜索

beamnxw ./ - inline image

搜不到

Jetha Chan - inline image

可被搜索到

被分享

beamnxw ./ - inline image

分享卡片无官方标识

Jetha Chan - inline image

带认证标识

支付能力

beamnxw ./ - inline image

Jetha Chan - inline image

可用微信支付

费用

免费

300元/年

主体限制

仅个人

个人/企业均可

个人主体也能认证,只是每年 300 元。如果你暂时不想花钱,可以先跳过——不影响发布,只是搜不到、分享没标识。

最常见的被拒有三种:涉及医疗、金融这类没提供资质的;涉及直播没开通权限的;还有上面自查第 2 条那个,页面空白或者功能不完整。

审核等多久?通常一到七天,以官方为准,。你的东西越简单、越不碰敏感领域,越块

你看,这不就做出来了

跟它说了句话,代码有了。

填个地址,页面出来了。

红字甩回去,它自己修好了。

扫个码,跑在你手机上了。

点一下上传,朋友能扫了。

从头到尾,不用懂代码。

今晚就干一件事:把微信开发者工具装上。十分钟。

装完你会手痒,想找点东西丢进去跑跑看。到那会儿,你就已经开始了。

身边有人念叨着想做个小程序又迟迟没动手的,把这篇转给他,能省他一个周末。

我是宋宋。持续分享干货。

二次創作

使用 YouMind 創作爆款文章

收集素材、拆解爆點、生成視覺資產、撰寫內容,並在一個 AI 工作空間裡完成分發。

了解 YouMind
寫給創作者

把你的 Markdown 變成乾淨的 𝕏 文章

圖片上傳、表格、程式碼區塊,往 𝕏 上手動重排太痛苦。YouMind 把整篇 Markdown 一鍵轉成乾淨、可直接發佈的 𝕏 文章草稿。

試試 Markdown 轉 𝕏

更多可拆解樣本

近期爆款文章

探索更多爆款文章