ARTICLE · 1218481
照着官方文档做小程序,我整理出6个坑
照着官方文档做小程序,我整理出6个坑9 月 24 号那天，WorkBuddy 发了个更新，说能一句话生成微信小程序并发布。我有点好奇是怎么搞得，于是我照着官方文档上手。 文档写得挺清楚，有三种创建方式，一是首页进「代码开发」选「小程序」用推荐场景，二是直接描述需求，三是把已有网页一句话改成小程序。 用直接描述创建时，需求里建议写明「微信小程序」五个字，不提它，它可能给你整个网页应用，发布路径完全不一样。 需求说清三件事就够，谁用、能做什么、数据要不要保存。不知道写什么，文档按用途分了五类场景，品牌展示、预约服务、活动服务，内部协作，轻量工具。你想要做的公司主页、到店预约、活动报名、器材借用、抽奖转盘都算，大概率能在里面找到邻居。 涉及存数据、登录、传图的时候，它会提示你开云服务，确认之后自己配好，你不用填任何技术参数。云服务官方文档里拆成四样，数据库存信息、认证分用户、存储传图片、统计看人数。也就是说，你的数据存在云端，换一部手机登录，也能看到自己的东西。 官方文档的需求示例是读书清单，我改了一段能直接复制的。 帮我制作一个微信原生小程序。发布为应用。 用户可以添加正在阅读和已经读完的书，记录书名、作者和阅读进度。 首页显示书架，区分在读和已读完两个分组。 每本书下面可以写读书笔记，按日期排列。 支持微信登录，每个人只看到自己的书架和笔记。 数据保存到云端，关闭小程序再打开也能继续使用。 页面简洁，按钮清楚，适合在手机上操作。 需要我开启云服务或授权时，直接告诉我下一步怎么做。 我按照官方给出的例子开始制作，然后故事开始不对劲。文档里有一个东西，叫微信小程序产物卡片，点开能进预览、能分享、能发布。可我三个小程序的对话里，连这张卡片的影子都没有。躺在那儿的只有本地文件，加一份能在浏览器里点的HTML预览。 
这是第一个坑，产物卡片不出现，我制作了三个小程序，结果全栽了。 我的第一个小程序是读书清单，满心以为生成完对话里就该有文档说的那张卡片。等了半天，没有。 回去翻文档，「预览和修改」节里对卡片的全部描述就一句话，生成完成后对话中会出现「微信小程序」产物卡片，点击卡片可以在右侧预览区查看效果。轻描淡写，像是这种事不需要解释。 可这句话三个小程序一次都没应验。读书清单、餐饮点单、门店预约，每一个都生成成功了，但是都没有所谓的小程序卡片，在对话里躺着的只有本地文件。 
我把问题抛给了workbuddy，让它自己去找问题在哪。 
在workbuddy给出的原因解释中，一个解释是因为我没有开启云服务，所以没有产生小程序卡片，一个解释是虽然我用了代码开发板块的小程序来创建了应用，但是创建不一定会激活最终的产出。 而这些都没有在文档中有说明。 当然最后还是给出了三个解决方案，但这三个方案里，我认为只有第二个还算是有点作用。所以如果你也想使用，或者正在使用workbuddy开发小程序，我建议你在开发之前先把[发布为应用]添加上。 
另外，虽然在给出的方案的写着用「发布为应用」技能可以生产成卡片，但实际上我在官方的技能中没有查到有这个技能，经过测试，实际上是需要你在会话的提示词中加入「发布为应用」这几个字即可。 
当然啦，卡片没出现，不代表你的小程序没做出来。这三个工程的代码都是全的，拿微信开发者工具导入，AppID填测试号，当场就能编译预览。卡片只是平台的包装层，不挡你真机验收。 第二个坑，预览不等于真机。 预览主要用于检查页面样式和基础交互，与微信内的实际运行效果可能存在差异，微信登录等能力，需要发布为试用版或体验版后，再通过微信进行真机测试。 翻译一下，你在电脑上看到的一切，仅供参考。 我在预览里把样式调了两小时，发到手机上，按钮挤成一团。预览里点哪都有反应，不代表微信里也正常。最要命的是登录，预览环境里根本测不了。不少人卡在这儿，在电脑上雕花两个小时，发到手机上傻眼。 别在预览里追求完美。第一版的目标不是把电脑上的效果雕到极致，是尽快发个版本到微信里，用自己的手点一遍。文档里还藏了一招，可以让WorkBuddy打开微信开发者工具，在真实的小程序环境里预览、真机调试、排查问题。卡在预览阶段时让它把开发者工具拉出来，很多玄学问题当场现形。 第三个坑，更新不同步，加两个藏在FAQ的故障。 「更新和下线」节写着，修改应用后，线上版本不会自动同步，可以在分享面板中点击「更新」。更新正式版需要重新提交微信审核。新版本审核通过并完成发布前，用户会继续使用当前已上线版本。 很多人默认改完就生效，然后到处问，我明明改了怎么没变化。新版本通过并发布之前，用户用的还是旧版，这是规则，不是故障。 文档「常见问题」里还有两个故障，专门开了FAQ条目，可见不是小概率。 一个是发布时提示「授权异常，请尝试重新授权小程序」。解法在微信公众平台，进「管理->账号设置->第三方设置->第三方平台授权管理」，找到已授权的平台点解除授权，回WorkBuddy重新扫码。你的小程序要是此前授权给别的代开发平台，要换绑过来，必须先走这套解绑。 另一个更阴。代码审核都通过了，扫码却提示「小程序已暂停」。你以为发布失败了，其实不是。去公众平台「管理->账号设置->账号信息」，找到「暂停服务」那一栏，点「恢复服务」，再扫码，好了。 这两个故障的解法存进备忘录，出问题按图索骥，别现场翻文档，人一着急就容易越翻越乱。 顺便记一笔，应用不想用了，只有正式版能主动下线，其他版本没这个入口。 
第四个坑，一周3次提审。 正式版审核期间不能再次提交新的正式版更新，每个微信小程序每周可以提交3次正式版审核，剩余次数以面板显示为准。 赶时间上线的人容易一天内反复改、反复提，改个文案提一次，调个颜色提一次。三次用完，要么等下周，要么干瞪眼。更亏的是拿这三次机会在打磨阶段试错，真正要发的时候名额没了。 把一周3次当预算花。所有改动先在体验版上验完，确认没问题再提交正式版。一次提审就是一次发版，要有发版的样子。 体验版是只有你邀请的人能打开的版本，其他人首次打开要申请权限，你去公众平台「管理->成员设置->体验成员」里批准了，对方才能进。上线前调试验收用它。 审核时间由微信决定，不由WorkBuddy决定，也不由你决定，WorkBuddy能帮你传代码、提交、看进度，但它变不出审核速度，也改不了平台规则。这话说在前头，免得有人以为用了AI就能插队。 要是审核没过，分享面板里会列出微信返回的完整原因，微信的服务通知也会发消息提醒。按原因改，改完先发体验版用真机验一遍，确认没问题再重新提审。别拿着没验证过的版本反复送审，那是在浪费一周 3次的名额。 第五个坑，正式上线前准备。 正式版提审前，有三件事必须在分享面板的「小程序设置」里逐项检查。 小程序备案，按微信官方流程给小程序上个户口。官方文档写明，未完成备案，微信可能限制新用户访问或暂停服务。所以它不是走个形式，建议早点启动。 用户隐私保护指引，告诉微信你的小程序收集了用户哪些信息、拿来干嘛。要按实际情况填写信息类型、收集目的、变动通知方式，以及你的联系手机号和邮箱。文档特意提醒，这项填写不完整，可能导致审核失败。 UGC信息安全声明，UGC是用户自己发的内容，社区、论坛、笔记、问答都算。提审这些类目时，要在公众平台「管理->账号设置->基本设置->服务内容声明」里填写，向微信说明你有能力管理用户发的内容。 看出来了吗，技术的事它全包，规矩的事一条没少。 现在问自己一句，玩票还是长线。玩票，试用版足够，别折腾备案。长线，备案是三件套里最耗时的，早一天启动早一天解脱。 
第六个坑，14 天的保质期。 试用版有效期为14天，到期后会自动注销，原小程序码将无法继续访问。往下还有一份不支持的功能清单，微信支付、小程序直播、不可以被搜索、没有 AppSecret、不可以扫码登录公众平台。 
除了一个微信号最多创建5个、最多支持15人体验，选试用版那个瞬间很顺滑，扫码、关注、授权、发布，三分钟搞定，顺滑到没人告诉你这一切有保质期。 到期之后想找回做过的东西，从头像进设置，数据管理，应用里统一管理。发布状态、云服务、小程序码都在这页，找不到了回去翻。 重点在文档的「注意」框里那两行。创建试用版后，可以解绑并重新选择发布方式，但试用版不能直接转为正式版。如需长期运营，建议绑定自己的小程序账号。 三个版本的账给你算平。 试用版，不需要账号，不需要审核，14天，15人，验证想法用。 体验版，需要账号，不需要审核，最多15名体验成员，上线前调试验收用。 正式版，需要账号，需要审核，需要备案三件套，对外运营用。 选错了不是走弯路，是再跑一遍发布流程。 
路线怎么选？ 只想看看效果，创建试用版，14天够你玩明白。 要长线，绑定账号先发体验版，验完再走正式版。 什么都没有又确定要长线，现在就去注册，一边注册一边生成和修改，账号下来正好接上，一天不浪费。 这波AI能力上来之后，到处都在喊，不会代码也能做产品。 口号没错，但它把最艰难的部分讲得太轻了。 写代码的门槛确实被拆了，服务器、数据库、部署，这些曾经的硬骨头收进一个确认按钮。但墙后面还有一排矮栅栏，卡片不出现、预览对不上真机、改完不自动更新、授权异常、一周三次提审、备案和14天注销。 AI不会替你把世界上的琐碎抹掉，一秒都不会。 所以我的看法是，红利不属于完全不想懂规则的人，属于愿意把规则当产品的一部分来读的人。 工具越来越强，理解力和执行力就越来越值钱。 👆 觉得有用点个赞，让更多想做小程序的人看到 💬 留言区聊聊，你有没有遇到过功能入口在、产物不出来的情况，最后怎么解决的 ↗️ 转发给也在折腾 AI 工具的朋友
