一、预览时提示 “未配置 appid”
- 解决办法：
- 注册小程序并获取 appid（登录微信公众平台→“设置”→“基本设置”→“账号信息”）。
- 在开发者工具项目设置中填入 appid：菜单栏 “项目”→“项目设置”→“基本设置”→“AppID” 输入。
- 若仅用于本地调试，可选择 “测试号”（无需真实 appid，但部分功能受限）。
二、真机调试连接失败（扫码后无反应）
- 解决办法：
- 确保手机与电脑连接同一 WiFi，且能互相 ping 通（电脑命令行ping 手机IP）。
- 关闭电脑防火墙或添加开发者工具到白名单（控制面板→“防火墙”→“允许应用通过防火墙”）。
- 更新手机微信到最新版本，重启手机后重新扫码。
三、运行时提示 “域名不在合法域名列表中”
- 解决办法：
- 开发环境临时关闭校验：开发者工具→“详情”→“本地设置”→勾选 “不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”。
- 正式环境配置：登录微信公众平台→“开发”→“开发设置”→“服务器域名” 添加域名（需备案且支持 HTTPS）。
- 检查请求 URL 是否包含端口（仅开发环境允许，正式环境域名不可带端口）。
四、页面空白（控制台报 “Failed to load page”）
- 解决办法：
- 检查app.json的pages字段是否正确配置页面路径（如”pages/index/index”是否存在对应文件）。
- 清除页面缓存：模拟器右上角 “清缓存”→“清除数据缓存”，重启项目。
- 检查页面js文件是否有语法错误（如未闭合的括号、变量未定义），修复后重新运行。
五、样式错乱（本地正常，真机预览异常）
- 解决办法： 统一使用 rpx 单位（避免 px，适配不同屏幕），检查app.wxss是否设置全局样式冲突。
- 确认选择器是否符合小程序规范（不支持通配符*，类名避免使用小程序保留字如wx-）。
- 真机调试时打开 “样式调试”：开发者工具→“真机调试”→“更多”→勾选 “启用样式调试”，定位具体样式问题。