我没写一行代码,让小程序页面在手机上跑起来了:中间就四步
- 2026-11-21 20:21:09
有个东西在我脑子里转了小半年。
不是什么复杂的玩意儿,就是一个能查白名单赛事信息的小工具。每次想起来都觉得"这个做出来应该挺好用",接着又想到"那得先学会小程序开发吧",于是又放下。
真动笔那天我才发现,方向想错了。
拦住我的从来不是代码。是我压根不知道,从"脑子里有个想法"到"手机上能点开",中间隔着四个步骤——而每一步的门槛,都低得出乎我的意料。
💡 先说结论
全程我没写一行代码。我干的只有两件事:把要什么说清楚,把结果改到能看。
从装工具到手机上第一次点开,就四步:装开发者工具 → 说清一句话需求 → 真机预览 → 改到能看。
第一个把我拦住的坑不是功能做不出来,是包体积:预览能过,上传过不了。

🔧 第一步:装开发者工具,十分钟
这一步没什么技术含量,但它藏着一个动作:新建项目的时候要填 AppID。
已经注册过小程序的,去公众平台后台把 AppID 抄过来填上。还没想好主体类型的,官方有一页叫「测试号」,扫码就分配一个小程序和小游戏测试账号,官方原话是"使用此账号在开发者工具创建项目进行开发测试,以及真机预览体验"。
我走的是第一条,因为上一回那件事(个人主体到底能不能收钱)我已经想清楚了。测试号我后来也试了一次,它特别适合"只想先看看能不能跑起来"这种情况——把注册、认证、备案这一串事,推迟到你真的决定要发出去的那天。
官方下载页当前稳定版是 2.02.2608080(2026 年 9 月 30 日),Windows 7 及以上、macOS 的 x64 与 ARM64 都能装。装完扫码登录,十分钟不到。
🗣️ 第二步:说清一句话需求,二十分钟
这一步是四步里最值钱的,也是最容易做砸的。
我第一句话说的是"帮我做一个白名单赛事的小程序"。它回了五个页面、一套底部导航、还有一堆我压根没要的功能——每个都只有一半。那天晚上我什么都没做出来。
后来我改成先填一张卡,四个空:
1给谁用
2打开第一屏要看到什么
3点一下会发生什么
4数据从哪来(第一版允许写死)
填完这四个空,再说"就做这个"。差别大得离谱:同样十几分钟,前一次拿到五个半成品,后一次拿到一屏能点能用的东西。
让它一次做完,是最贵的做法。先要一屏,比先要五页快得多。
📋 能直接抄的「一句话需求卡」:
我要做一个小程序的一个页面,先只做这一屏,能跑起来就行。
- 给谁用:
- 打开第一屏要看到:
- 点一下会发生什么:
- 数据从哪来(第一版可以先写死):
─── 约束 ───
1. 只生成这一个页面,不要生成其他页面,也不要加导航
2. 数据先写死在页面里,不要引入外部数据文件
3. 按小程序规范出文件:js / wxml / wxss / json 四个同名同目录
4. 不要引入任何第三方库
5. 写完告诉我:每个文件叫什么、放哪个目录、预览前要点什么
最后那句"预览前要点什么"是我后来加的。它会把下一步的操作顺序一起说出来,省得你自己去猜按钮在哪。

📱 第三步:真机预览,五分钟
点开发者工具顶上的「预览」。
工具会自动打包、把代码传到微信服务器,然后弹一个二维码。官方发布流程文档里那句原话是"使用当前小程序开发者的微信扫码"——也就是说这个码得用你自己的微信扫,发给别人扫是打不开的。
为什么不看模拟器?因为模拟器会骗人。
| 整体小一圈,长辈基本看不清 | ||
| 被手势区吃掉一截,按钮点不到 | ||
这三处我不写具体数值,因为机型和字号设置都不一样,写死一个数反而误导你。
模拟器是给自己看的,真机是给用户看的。中间隔着一个二维码。
✏️ 第四步:改到能看,反复
手机上看着不顺眼的地方,一条条抄回来,让它改。
这里有个很关键的规矩:一次只提一条。
我试过一口气提五条,它改了三条、漏了两条,还顺手改了一个我没让它动的地方。后来改成一次一条,改完再预览,一轮两三分钟,总共反而更快。
📋 能直接抄的改稿句式:
下面是这个页面在真机上的一个问题,请只改这一处,
其他任何地方都不要动:
- 页面:
- 问题出现在:(说清是哪个元素、什么情况下)
- 我希望它变成:
改完只告诉我:你改了哪个文件的哪几行,不要重述整份代码。
"其他任何地方都不要动"这句必须写。不写,它就会顺手帮你"优化"一下,然后你得从头再核一遍。
📦 第一个真实的坑:预览能过,上传过不了
手机上看着挺好的,我兴冲冲点了「上传」——报错 80051,包体积超限。
官方文档《分包加载》里写着:单个分包/主包大小不能超过 2M;整个小程序所有分包大小不超过 30M(服务商代开发的小程序不超过 20M)。我那点东西全在主包里,撞的就是这 2M。
那预览怎么没事?
因为官方项目配置里有个开关叫 bigPackageSizeSupport,说明原话是:预览及真机调试时主包、分包体积上限调整为 4M(小程序)、8M(小游戏)。

预览和上传不是同一条及格线。手机上看得好好的,不代表传得上去。
多出来的体积是哪儿来的?我翻了一遍项目目录,全是些开发用的中间文件:跑数据的脚本、历史版本的封面图、一堆 .json 和 .md。它们从来没参与过页面显示,却每一个都算进了包里。
解法在项目根目录的 project.config.json,用 packOptions.ignore 把它们排除掉。官方说明:配置打包时对符合指定规则的文件或文件夹进行忽略,以跳过打包的过程,这些文件或文件夹将不会出现在预览或上传的结果内。type 支持 file、folder、suffix、prefix、glob、regexp 六种。
"packOptions": {
"ignore": [
{ "type": "folder", "value": "scripts" },
{ "type": "folder", "value": "_preview" },
{ "type": "suffix", "value": ".md" }
]
}
官方那句提醒值得划重点:这部分设置的更改可能需要重新打开项目才能生效。我第一次改完没重启工具,以为这招没用,白折腾了二十分钟。
还有一个更容易踩的点:官方《目录结构》里有一份"允许上传的文件"后缀白名单(wxs、png、jpg、jpeg、gif、svg、json、cer、mp3、aac、m4a、mp4、wav、ogg、silk、wasm、br、cert)。不在名单里的文件,在开发者工具里你看得见,但传不上去。所以别指望在项目目录里塞个 .xlsx 当数据源。
🧱 页面和数据,一开始就该分开
官方目录结构写得很清楚:一个小程序主体由 app.js(必需)、app.json(必需)、app.wxss(可选)三个文件组成;一个页面由 js、wxml、json、wxss 四个文件组成,而且这四个文件必须具有相同的路径与文件名。
我第一版把内容全写死在页面里。改一个错别字,也要重新上传一遍。
后来我把"会变的"和"不会变的"分开:不会变的是界面骨架,会变的是内容本身。骨架留在页面里,内容抽出去单独放。
判断标准只有一句话:下次改的时候,你愿不愿意为它重新上传一遍?愿意,它就该是页面;不愿意,它就该是数据。
🔍 三个反直觉
第一,先要一屏,比先要五页快得多。五个半成品凑不出一个能用的东西,一屏能用就能拿去给人试,试完才知道下一屏该长什么样。
第二,预览通过不等于上传通过。4M 和 2M 是两条线,别等到点上传那天才发现。
第三,越早上真机,总时间越短。我在模拟器里调了两天的间距和对齐,真机上全白调。
📌 一句收尾:四步走完,从装工具到手机上第一次点开,总共花了我两个星期的时间,是因为有些需求是边想边做的,如果想清楚了可能半天就能搞定。真正让我停了半年的不是难度,是我一直以为中间隔着"学会写代码"。很多事不是难,是你没去做过。现在我的小程序已经上线了教育部白名单47项赛事报名入口一键查如果你也想试试快开始吧。
“说说你的
你脑子里有没有一个转了很久、一直没动手做的小东西?它卡在哪一步——是想法还没定型,还是卡在"动手"那一下?评论区聊聊,我挺好奇大家卡的是哪一种。
👋 常来逛逛:这里每周都在拆「普通人用 AI 做出一个能用的东西」的真实过程——不卖课、不带货,只讲走了多远、卡在哪、怎么过的。