用 WorkBuddy 做微信小程序，小白看完都能直接上手

Fri, 18 Sep 2026 07:10:00 +0800

本文整理自宋宋（@songsong）2026 年 8 月 7 日的沉浸式教程，原文：https://x.com/songsong/status/2085700722197438652

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

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

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

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

看完这篇，这些你就全会了：

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

先看我的成品。

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

01 开工前的十分钟

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

然后，别说"帮我做一个小程序"，而是这样说：

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

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

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

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

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

有几点要注意：

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

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

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

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

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

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

02 来看半成品

打开刚下好的微信开发者工具，扫码登录之后，直接点击 +。然后填写这三个：

项目名称：随便起，你自己认得就行。
目录：粘贴上一步那个地址。
AppID：红色，没关系，点击测试号，丝滑继续。

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

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

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

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

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

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

03 满屏红字，谁写的谁修

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

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

具体动作是这样：

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

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

不过有两点要注意：

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

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

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

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

04 你在电脑上看着挺好，手机上可能不一定

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

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

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

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

你点的	你得到什么	什么时候用
预览	手机上直接打开，看效果最快	平时改一版看一眼，用这个
真机测试	手机上跑完整流程，还能选安卓或者 iOS	想知道两种手机上表现一不一样，用这个
远程调试	手机上跑，同时电脑上能看到日志	手机上出了 bug 但电脑上复现不了，用这个

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

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

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

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

05 别让朋友帮你测 bug

五分钟的事，自己先跑这五项：

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

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

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

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

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

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

06 发个码，给朋友扫

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

打开微信公众平台，走注册流程。 账号类型有好几种，公众号、小程序、小游戏都在那儿，认准小程序那个。⚠️ 选错了改不了，只能注销重来，看清楚再点。
填一个干净的邮箱。 填上邮箱然后点击右边激活邮箱。会给你邮箱发验证码，输入验证码，再填上你的密码进行注册。

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

拿到 AppID，直接把这句话发给你的 WorkBuddy：

把项目里的 AppID 改成我的 AppID：wx开头那一串

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

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

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

两件事要注意：

第一，上传不等于发布。 上传成功只代表开发版本已经进了后台，还没有正式发布。你的小程序现在搜不到，只有拿到码的人能进。
第二，体验版有期限。 一般是七天。过期了重新上传一版，再出一个码就行。所以它适合给几个朋友试试、适合拿去给人演示。

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

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

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

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

07 关掉也不丢

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

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

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

工具顶部点「云开发」→ 开通 → 记下环境 ID。点击开通，它先会弹一个支付 19.9 每个月，等一下，它会自动引导跳到免费开发环境。

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

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

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

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

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

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

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

然后重新导入你要存数据版本的小程序项目，AppID 把你的贴过来，后端服务选择微信云开发。这样，数据就通了。

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

08 让陌生人也能搜到你

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

先过六条自查：

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

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

🔴 我给你整理好了，直接把下面这段甩给 WorkBuddy 即可：

我要提交微信小程序审核，帮我按下面几条逐条检查这个项目。
能你自己改的直接改，改不了的告诉我去哪儿填什么。project.config.json 里的 appid，现在填的是不是测试号。
列出 app.json 里所有页面路径，做成一张清单，
我照着一个个点开看有没有白屏。
全项目搜 wx.request、wx.uploadFile、wx.downloadFile、
wx.connectSocket，把里面出现的域名全提出来，
按这四类分组列成表，标出哪些不是 https 或 wss 开头、
哪些填的是 IP。这张表我拿去后台配服务器域名。
project.config.json 里的 urlCheck，如果是 false 就改成 true，改完告诉我。

全项目搜用户信息类接口，头像昵称、位置、通讯录、相册、
麦克风、剪贴板这些，列出用到了哪几个、分别在哪个文件哪一行。
这张表我拿去后台填用户隐私保护指引。
代码里还有没有调试用的 console.log 没清掉。
最后出一张总表，一行一条，三列：检查项、现在什么情况、
我下一步要做什么。你自己改掉的写"已改"，
要我去微信后台手填的写清楚填什么，查不出来的写"查不到"，不许猜，也不许拿常识补。

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

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

1️⃣ 小程序信息（点"去填写"）

这个最基础，必须填：

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

2️⃣ 小程序类目（点"去补充"）

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

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

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

3️⃣ 小程序备案

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

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

4️⃣ 微信认证（可选，但强烈建议做）

对比项	不认证	认证后
被搜索	❌ 搜不到	✅ 可被搜索到
被分享	❌ 分享卡片无官方标识	✅ 带认证标识
支付能力	❌ 无	✅ 可用微信支付
费用	免费	300元/年
主体限制	仅个人	个人/企业均可

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

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

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

你看，这不就做出来了

跟它说了句话，代码有了。填个地址，页面出来了。红字甩回去，它自己修好了。扫个码，跑在你手机上了。点一下上传，朋友能扫了。

从头到尾，不用懂代码。

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

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

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

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

本文内容版权归原作者宋宋所有，转载已注明出处。文中涉及的限时免费、优惠活动等信息以官方实际为准。

微信小程序 on 我的博客