想做个微信小程序,你可能会先被一堆东西拦住:微信开发者工具、项目目录、AppID、云开发环境、数据库、上传、后台版本管理。
这都是啥啊,一行代码还没写呢。就给我整这些有的没的,然后就卡在这儿了。
没关系,没写过代码、没做过小程序、连 AppID 是啥都不知道,这篇就是写给你的。
一个下午就能做出来,是种怎样的体验
看完这篇,这些你就全会了:
- 把代码导进微信开发者工具(AppID 都不用先注册)
- 在自己手机上打开它
- 出个二维码,发给朋友试
- 提审、上线、被人搜到
先看我的成品。

怎么样,感觉还行吧,那咱话不多说,开整。
一、开工前的十分钟
打开workbuddy,在专家、技能、连接器那一栏里找到微信小程序开发者这个专家,把它召唤出来。

然后,别说"帮我做一个小程序
1我想做一个自己使用的每日习惯打卡的小程序,2第一步,我需要跟你沟通什么内容?先不要写代码,我们先讨论一下。
把"每日习惯打卡"换成你自己的。
然后它会问你,你的数据想怎么存、第一版功能想做到多完整、打算用什么方式开发这个小程序、需要每天打卡提醒么、习惯类型是什么样的、打卡提醒的时间粒度是什么样的、界面视觉风格偏好,最后还会问你 针对分类维度、归档删除和统计周期再进行微调。
这些你之前都没想到的问题,它都帮你一一想好,然后定好方向。
先不用大而全,先让它把1.0版本先搭起来,然后有了基础框架,我们就可以慢慢调整,修修改改。然后方向等内容都定好了就让它开干。
然后在它写代码的这段时间,你可以先去装微信开发者工具。
微信官方出的,因为你的小程序最后要在它里面跑、预览、上传。搜"微信开发者工具"进官方下载页,选稳定版,一路下一步,装完扫码登录。一进去就是这样的。

有几点要注意:
💡 第一次做,功能就留一两个。 功能越多,要生成的页面越多,冒出来的报错也越多,每个都得你自己复现一遍、描述给它听。所以先把核心搞定,再说其他的。
💡 模型换成 HY3,别挂着 auto。 它现在限时免费,无限畅饮。(限时活动,你看到这篇的时候先去后台瞄一眼还在不在。)
⚠️ 菜单名跟我说的对不上,是常事。 这类软件更新太勤。有问题直接把截图丢给workbuddy,它告诉你点哪儿。
代码写完,它给你一个项目文件夹的地址,一般是软件按时间建的目录,末尾是你这个项目的名字。对这个地址有个印象,下一步要用到。 它通常还会顺手给你一段导入指引,没给就直接问:"代码写好了,我怎么把它导进微信开发者工具?"
这时候,你手上有:一整套小程序代码,和一个装好的微信开发者工具。
东西都齐了。要测试预览看看半成品了。
二、来看半成品
打开刚下好的微信开发者工具,扫码登录之后,直接点击 +。
然后填写这三个:
- 项目名称:随便起,你自己认得就行。
- 目录:粘贴上一步那个地址。
- AppID:红色,没关系,点击测试号,丝滑继续

后端服务 先点选不使用云服务。填完点创建,再点信任并运行,工具会自己开始构建。
⚠️ 什么时候必须换正式 AppID:如果要使用微信云开发,想上传,其他人可以体验的,就用邮箱注册一个免费的。 本文第六章会详细讲。
⚠️ 另外,注册前先想清楚你要做哪一类。有小游戏和其他,选择了就不能改了,所以要选择前要仔细想清楚。
顺利的话,构建完你就能在工具里看见自己的小程序了,左边是模拟器,右边是代码。
这时候,你手上有:一个能在电脑上跑起来的小程序。
也可能你看见的是满屏红字。别慌,好修。
三、满屏红字,谁写的谁修
第一次构建出一堆红字,正常。
处理办法就一句话:谁写的谁修。😂
具体动作是这样:
- 在微信开发者工具里找到调试器面板,红色的报错都在里面。
- 把报错内容整段复制,别只截一半,也别自己转述。
- 发给workbuddy ,啥都不用说,它看完直接帮你修好
它分析完,如果它能修的直接修好,需要你去设置的 就会引导你需要做什么,很简单。
不过有两点要注意:
⚠️ 有一类"错"不算错:小程序不支持一部分网页写法。比如某些选择器、鼠标悬停效果,在电脑上看着不对劲,是因为小程序压根就不支持。这种直接跟它说"这个效果小程序不支持,换一种实现"。
⚠️ 还有一类是假错:改完不生效。先别怀疑它,在工具的右上角普通编译旁边有个 刷新的按钮点一下编译强制刷新,八成就好了。
这时候,你手上有:一个不再白屏、无问题丝滑的小程序。
电脑上看着挺美。模拟器上点得动,但是真机上未必。
四、你在电脑上看着挺好,手机上可能不一定
小程序在电脑模拟器里跑得顺,到手机上样式错位、按钮点不动,是常事。屏幕尺寸不一样,触摸和鼠标也是两码事。
把它弄到手机上,就点一个按钮:预览。

工具会生成一个二维码,你用手机微信扫,你的小程序就在手机上打开了。
这儿最容易搞混:预览、真机测试、远程调试,这三个都能给你弹个二维码出来,到底有啥区别呢?
你点的
你得到什么
什么时候用
预览
手机上直接打开,看效果最快
平时改一版看一眼,用这个
真机测试
手机上跑完整流程,还能选安卓或者 iOS
想知道两种手机上表现一不一样,用这个
远程调试
手机上跑,同时电脑上能看到日志
手机上出了 bug 但电脑上复现不了,用这个
⚠️ 别拿预览当测试用。预览是给你自己大致看看效果的,看着没问题不代表跑得通。确认还是要走真机测试。
⚠️ 还有一条:为了方便调试开发阶段工具里有些校验是关着的,但真机上该校验的还是照样校验。所以有的时候电脑上没事、手机上一堆问题。
这时候,你手上有:一个在你自己手机上能打开的小程序。
手痒了吧,是不是想立马甩个码给朋友。稍等,还得跑五件事,要不可能全是bug😂。
五、别让朋友帮你测 bug
五分钟的事,自己先跑这五项:
- 添加:加一条新的,能不能出现在列表里。
- 状态:切换完成和未完成,切得动吗。
- 重进:退出小程序再重新打开,你刚才加的东西还在吗。
- 删除:删掉一条,刷新之后它有没有又冒出来。
- 空值:什么都不填直接点添加,它应该给你个提示,而且不能产生一条空记录。
第三项和第五项不专门去试就会漏。
修完任何一项,五项全部重跑一遍,别只补测你刚修的那一项。改 A 弄坏 B 是常态。
⚠️ 五项都过了,也只说明它不会当场崩。但是这个过程也是打磨的过程,总能发现奇奇怪怪的问题,然后自己又灵光乍现,这里加一个新奇功能,又会发现这里颜色不对了,那里按钮错位了,总之这里可能会耗上一段时间,最终都是为了呈现一个 自己满意的版本。
这时候,你手上有:一个自己验过、打磨过满意的小程序。
东西打磨得差不多了。想发给朋友,还差最后一样:正式身份。
六、发个码,给朋友扫
想让别人扫,你得先有个正式的 AppID。怎么注册呢:
- 打开微信公众平台,走注册流程。 账号类型有好几种,公众号、小程序、小游戏都在那儿,认准小程序那个。⚠️ 选错了改不了,只能注销重来,看清楚再点。
- 填一个干净的邮箱。 填上邮箱然后点击右边激活邮箱。会给你邮箱发验证码,输入验证码,在填上你的密码 进行注册。

- 选主体。 自己玩就选个人,身份证实名加微信扫码验证,不花钱。
- 进后台,在开发管理里找到 AppID,一串 wx 开头的,复制出来。

拿到 AppID,直接把这句话发给你的 workbuddy:
1把项目里的 AppID 改成我的 AppID:wx开头那一串
然后回到微信开发者工具,右上角点上传。

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

这时候就可以发给朋友们炫耀你的小程序啦。他扫了就能用,不需要你上架,也不需要过审核。
两件事要注意:
第一,上传不等于发布。 上传成功只代表开发版本已经进了后台,还没有正式发布。你的小程序现在搜不到,只有拿到码的人能进。
第二,体验版有期限。 一般是七天。过期了重新上传一版,再出一个码就行。所以它适合给几个朋友试试、适合拿去给人演示。
⚠️ 很多人到这儿就够了。 自己用、发几个朋友试试,体验版够使,七天一换而已,认证备案我后面章节再详细讲。
这时候你手上有:一个能发给朋友扫的体验版二维码。
到这儿,你已经做出一个真的小程序了。
朋友扫了码,进去玩了两下,加了几条东西。等他一关小程序,全没了。怎么让数据存下来呢
七、关掉也不丢
走到这儿,有件事一直没解决:你的数据,到底存在哪。
打卡记录也好,清单内容也好,只存在手机本地的话,换个手机就没了,也没法两个人一起用。要存数据,需要有后端。
自己搭后端意味着什么?后端接口、数据库、服务器部署、域名、HTTPS,还有小程序后台的合法域名配置,六样,一样都不能少,而且域名还得是备案过的。咱不整这些麻烦的,直接走云开发。数据库和后端逻辑都放在云上,小程序直接调,上面那些你不用操心。
- 工具顶部点「云开发」→ 开通 → 记下环境 ID。
点击开通,它先会弹一个支付19.9每个月,等一下,它会自动引导跳到免费开发环境

- 复制这个环境ID 直接发给workbuddy 让他帮你设置globalData.env的环境ID即可。

- 云开发控制台 → 数据库 → 新建三个合 categories / habits / checkins,权限都设为「仅创建者可读写」。这几个集合 ,可以根据workbuddy给你生成对应的来创建,它会告诉你要创建那几个集合。

- 右键 cloudfunctions/login → 上传并部署:云端安装依赖。这里是回到你的微信开发工具里的工程文件里。
这里解决的就是:让云函数能找到它需要的第三方包,否则云端一运行就崩。

一个坑点:如果你在你的项目文件里没有找到cloudfunctions ,可能你的导入项目文件夹不对,找到你之前导入的文件夹地址,改成更上一层的文件夹即可
然后 数据落地准备好了,重新加载工程,但它会问你要两个东西,小程序 AppID 和云开发环境 ID。
⚠️ 走这条路就用不了测试号了,AppID 必须是正式的。上面已经教大家怎样获取了。
⚠️ 云开发对新用户有时候有优惠活动。但是有时效性,有时有,有时没有。
然后重新导入你要存数据版本的小程序项目,APPID 你把你的帖过来,后端服务选择 微信云开发。
这样,数据就通了。

存数据,搞定了。如果让别人搜到你或者商用,下面挑战才刚开始。
八、让陌生人也能搜到你
体验版能跑,跟能过审是两码事。
先过六条自查
- AppID 换成正式的了吗。 测试号上不了架。
- 每个页面都点一遍,别有白屏,别有点了就崩的地方。
- 服务器域名配了吗。 你的小程序要是会去外面取数据,那些地址得先在小程序后台配上,位置是 开发 → 开发设置 → 服务器域名,按接口分四类填:request、socket、uploadFile、downloadFile。只认 https 和 wss,而且域名必须已经备案。 另外填 IP 不行,只填个父域名也不行。
- 把开发者工具里那个"开发环境不校验请求域名、TLS 版本及 HTTPS 证书"的勾取消掉。 它只在开发者工具和调试模式的手机上管用,真机非调试模式照样校验。域名配好了就关掉,关掉之后各端再跑一遍确认。
- 碰用户信息的,把用户隐私保护指引填了。 注意是"碰"才要:你的小程序要是会读头像昵称、位置、通讯录这类东西,就得在小程序后台的用户隐私保护指引里声明清楚。没声明的那些接口会被直接禁用,压根调不起来。 纯本地记事、一点用户信息都不碰的,这条跳过。
- 名称、头像、简介、类目在后台填完整。 类目选错是常见的退回理由。
💡 走云开发、或者压根不联网的,第 3 条和第 4 条跳过。
🔴 我给你整理好了 ,直接把下面这段甩给 workbuddy即可:
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,改完告诉我。1011全项目搜用户信息类接口,头像昵称、位置、通讯录、相册、12麦克风、剪贴板这些,列出用到了哪几个、分别在哪个文件哪一行。13这张表我拿去后台填用户隐私保护指引。14代码里还有没有调试用的 console.log 没清掉。15最后出一张总表,一行一条,三列:检查项、现在什么情况、16我下一步要做什么。你自己改掉的写"已改",17要我去微信后台手填的写清楚填什么,查不出来的写"查不到",不许猜,也不许拿常识补。
⚠️ 第 2 条别糊弄。 官方明确要求提交的得是个完整成品,测试版、带着严重 bug 的版本会被打回。被拒理由里最冤的就是"页面空白或者功能不完整",审核要求还是挺严的。
然后就是提交审核前的 4 道门槛

1️⃣ 小程序信息(点 去填写)
这个最基础,必须填:
- 名称:建议起个有辨识度的,比如「习惯打卡」「微习惯打卡」「每日打卡」之类的(个人主体不能含"微信/官方"等字眼,2-30个字符)
- 图标:正方形,选一个 1024×1024 PNG,圆角或圆形都行
- 简介:一句话说明功能,比如「每日微习惯打卡,记录成长每一天」
- 服务范围:选「工具 > 效率」或「生活服务 > 生活助手」
2️⃣ 小程序类目(点 去补充 )
个人主体的类目选择比较受限,推荐路径:
- 一级类目:工具
- 二级类目:效率 或 记事本
如果工具类下没有合适的,也可以试 生活服务 > 生活助手。类目决定了你能用什么 API,打卡类小程序一般走「工具-效率」没问题。
3️⃣ 小程序备案
2024年起微信要求小程序必须做 ICP 备案才能发布。流程:
- 填完上面「信息」和「类目」后这里才解锁
- 个人主体备案需要:身份证正面照 + 人脸核验
- 一般 1-3 个工作日出结果
- ⚠️ 不备案 = 不能发布上线
4️⃣ 微信认证(可选,但强烈建议做)
不认证
认证后
被搜索
搜不到
可被搜索到
被分享
分享卡片无官方标识
带认证标识
支付能力
无
可用微信支付
费用
免费
300元/年
主体限制
仅个人
个人/企业均可
个人主体也能认证,只是每年 300 元。如果你暂时不想花钱,可以先跳过——不影响发布,只是搜不到、分享没标识。
最常见的被拒有三种:涉及医疗、金融这类没提供资质的;涉及直播没开通权限的;还有上面自查第 2 条那个,页面空白或者功能不完整。
审核等多久?通常一到七天,以官方为准,。你的东西越简单、越不碰敏感领域,越块
你看,这不就做出来了
跟它说了句话,代码有了。
填个地址,页面出来了。
红字甩回去,它自己修好了。
扫个码,跑在你手机上了。
点一下上传,朋友能扫了。
从头到尾,不用懂代码。
今晚就干一件事:把微信开发者工具装上。十分钟。
装完你会手痒,想找点东西丢进去跑跑看。到那会儿,你就已经开始了。
身边有人念叨着想做个小程序又迟迟没动手的,把这篇转给他,能省他一个周末。
我是宋宋。持续分享干货。





