小程序常见问题
开发环境问题
Q: 微信开发者工具导入项目后编译失败怎么办？
A: 请检查以下几点：
- 确保已安装 Node.js 环境并配置正确
- 检查项目目录是否完整，特别是
node_modules文件夹 - 尝试删除
project.config.json文件后重新导入 - 更新微信开发者工具到最新版本
Q: 如何获取小程序 AppID？
A: 1. 登录 微信公众平台 2. 在左侧菜单中选择「开发」→「开发设置」 3. 在「开发者ID」部分可以找到 AppID(小程序ID) 4. 如无账号，需先注册并认证小程序账号
Q: 小程序提示「未找到 app.json 或 pages.json」如何解决？
A: 这通常是项目导入路径不正确导致的。请确保导入的是小程序根目录，该目录下应包含 app.json 文件。
功能使用问题
Q: 小程序无法获取壁纸数据怎么办？
A: 请按以下步骤排查：
- 检查 WordPress 插件是否已激活
- 确认 API 基础地址配置正确（在
utils/api.js中） - 检查 WordPress 后台是否有壁纸数据
- 在微信开发者工具的「网络」面板查看 API 请求是否成功
Q: 用户登录功能无法使用如何处理？
A: 1. 确保小程序 AppID 已正确配置 2. 检查服务器域名是否已在微信公众平台添加 3. 确认 WordPress 插件中的用户认证模块正常工作 4. 查看控制台错误信息，检查登录 API 返回结果
Q: 壁纸下载功能失效怎么办？
A: 1. 检查是否已获取用户相册授权 2. 确认壁纸文件 URL 可访问 3. 检查网络连接是否正常 4. 在微信开发者工具中测试下载接口是否返回正确数据
技术问题
Q: 小程序提示「不在以下 request 合法域名列表中」如何解决？
A: 1. 登录微信公众平台 2. 进入「开发」→「开发设置」→「服务器域名」 3. 在「request 合法域名」中添加您的 WordPress 网站域名 4. 保存后等待配置生效（通常需要10-15分钟）
Q: 如何调试小程序 API 请求？
A: 1. 打开微信开发者工具 2. 点击右侧「调试器」→「网络」 3. 触发 API 请求后，可以在网络面板中查看请求详情 4. 检查请求 URL、参数和响应数据是否正确
Q: 小程序包体积过大无法上传怎么办？
A: 1. 压缩图片资源，使用适当尺寸的图片 2. 删除未使用的代码和资源文件 3. 使用分包加载功能拆分代码包 4. 优化第三方库，只引入必要的模块
兼容性问题
Q: 小程序在某些手机上显示异常怎么办？
A: 1. 检查是否使用了固定像素单位，建议使用 rpx 响应式单位 2. 在微信开发者工具中切换不同设备型号进行测试 3. 检查 CSS 兼容性，避免使用过于新的 CSS 特性 4. 针对低端设备添加降级处理方案
Q: 小程序支持的最低微信版本是多少？
A: 建议用户使用微信 7.0.0 及以上版本，以确保所有功能正常使用。可在 app.json 中设置 miniprogramRoot 字段指定最低版本要求。
其他问题
Q: 如何获取小程序的更新通知？
A: 1. 关注微信公众号「晚夜深秋科技」 2. 加入官方 QQ 交流群：123456789 3. 定期查看项目 GitHub 仓库的更新日志
Q: 小程序是否支持多语言？
A: 目前小程序默认支持中文，如需添加其他语言，可修改 utils/util.js 中的语言配置文件，并在页面中使用多语言函数。
Q: 如何提交小程序的 bug 报告或功能建议？
A: 1. 通过 GitHub Issues 提交：https://github.com/username/wanyesea/issues 2. 发送邮件至：support@wanyesea.com 3. 在小程序「关于我们」页面点击「反馈建议」