🛠️ 零基础用 Claude Code 做出第一个小程序 · 第 2 周:做成微信小程序,跑在你手机上

小程序真机预览与调试:预览二维码、真机调试、体验版(零基础)

模拟器正常不算数,手机上正常才算

一句话先懂 · TL;DR

预览、真机调试、体验版三种方式的区别和用途,手机上白屏最常见的三个原因,怎么把手机端的报错交给 Claude Code 修。

三种上手机的方式

开发者工具右上角有三个相关按钮:

- 预览:生成二维码,你用微信扫,手机上立刻跑最新代码。日常改完就扫,最常用。
- 真机调试:手机跑的同时,电脑上能看到手机端的控制台报错。手机上出问题时用。
- 上传 → 体验版:上传后在小程序后台设为体验版,添加「体验成员」,他们不用扫开发码也能打开。给朋友和客户试用时用。

⚠️第 7 课的教训再来一遍:模拟器正常不算数。屏幕尺寸、系统版本、网络环境都不一样,手机上跑一遍才算验收。

手机上白屏的三个常见原因

1. 网络请求被拦:小程序只允许请求后台配置过的「合法域名」。用云开发不需要配;一旦引入了第三方接口就会撞上。我们 CLAUDE.md 里那条红线就是防这个。
2. 手机微信版本太旧,不支持某个新 API。让 AI 用兼容写法或做能力检测。
3. 模拟器里勾了「不校验合法域名」,所以电脑上正常、手机上不正常。这是最常见的「我这里好的」。

交给 AI 的正确姿势:
「真机调试控制台报错:(原话)。手机微信版本 8.0.x,机型 xxx。请修复,只改相关文件,并说明为什么模拟器里没有报错。」

自测 · 学完检查一下

想真正动手做题、记进度、攒连胜?到互动课里练。

你想让 5 个朋友帮忙试用一周,反馈问题。该用哪种方式?

答案:上传体验版,把他们加为体验成员

体验版就是为「一批固定的人长期试用」设计的。预览码有效期短、每次改动都要重发;装开发者工具对非开发者太重;提交审核是给所有用户上线的动作,还没到那步。

手机上打开是白屏,模拟器却正常。你想看到手机端到底报了什么错,该用?

答案:真机调试

只有真机调试能把手机端的控制台输出回传到电脑。预览和体验版只让你看到现象,模拟器则根本不是手机。

真机调试显示「request:fail url not in domain list」。这说明什么,该怎么办?

答案:代码里请求了未配置的外部域名;要么去后台配合法域名,要么按红线改回云开发

这条报错的原话已经把原因说完了:域名不在列表里。它正是 CLAUDE.md 红线「不使用需要合法域名的外部请求」要防的。让 AI 说明为什么模拟器没报错,你就会发现是勾了「不校验」。

判断:朋友用体验版反馈「点添加没反应」,你在模拟器里试了正常,可以回复他「我这边正常,可能是你手机问题」。

答案:

第 7 课和本课都在讲同一件事:别人的手机上不行就是真问题。正确做法是问机型和微信版本,自己用真机调试复现,把报错原话交给 AI。

想边练边学,而不只是读?

到互动课里答题、记进度、攒连胜——游客即可试学,无需注册。

进入互动课程 →

学点新东西,不错过更新

新课程、新功能、学习小技巧——偶尔一封,随时退订。