邢台小程序常见功能开发要点

开发环境搭建

工具准备：下载微信开发者工具（官方 IDE，必须使用）、注册小程序账号（在 mp.weixin.qq.com 注册，需要邮箱和实名认证）、获取 AppID（每个小程序的唯一标识，开发时需要配置）。

项目初始化：微信开发者工具 → 新建项目 → 填入 AppID → 选择模板（官方模板或空白模板）→ 创建。目录结构：pages（页面文件）、components（公共组件）、utils（工具函数）、app.js（全局逻辑）、app.json（全局配置）、app.wxss（全局样式）。

版本管理：强烈建议使用 Git 进行版本控制。即使是一个人的项目也能帮你追溯历史、分支开发、回滚错误。

页面开发

WXML（类似 HTML）：描述页面结构。常用组件：view（容器）/ text（文本）/ image（图片）/ scroll-view（滚动区域）/ swiper（轮播）/ input（输入框）/ button（按钮）/ navigator（页面跳转）。

WXSS（类似 CSS）：描述页面外观。支持大部分 CSS 属性。特性：rpx 单位（ responsive pixel，适配不同屏幕宽度）、全局样式和局部样式。

JS（逻辑层）：处理用户交互、调用 API、数据管理。生命周期函数：onLoad（页面加载）、onShow（页面显示）、onHide（页面隐藏）、onUnload（页面卸载）。数据绑定：this.setData() 更新视图。

常用功能实现

网络请求：wx.request() 封装。注意：必须在后台配置合法域名（开发阶段可以关闭校验）、建议封装统一的请求方法（处理 token、统一错误处理、loading 状态）。

微信登录：wx.login() 获取 code → 发送到后端换取 openid/session_key → 建立用户会话。注意：code 只能使用一次、openid 可以标识用户唯一身份、敏感数据（手机号等）需要用户主动授权。

微信支付：后端调用统一下单 API → 返回 prepay_id → 前端 wx.requestPayment() 调起支付。注意：支付需要商户号资质、需要 HTTPS 域名、回调通知要做好幂等处理。

获取用户信息：新版 API（2021 年后）需要方式获取用户授权。不能再通过 wx.getUserInfo 直接获取。

获取手机号：方式获取加密数据，后端解密。这是获取用户手机号的唯一合法方式。

性能优化

分包加载：小程序主包大小限制 2MB。使用 subpackages 配置将不常用的页面放到分包中，按需加载。

图片优化：使用 webp 格式（体积更小）、懒加载（image 组件 lazy-load 属性）、CDN 加速（图片上传到 OSS/COS）、合适尺寸（不要用 2000px 的图显示在 200px 的区域）。

setData 优化：setData 是小程序渲染性能的关键瓶颈。不要频繁调用、尽量一次 setData 传递所有变化、大数据量使用 wxs 过滤。

缓存策略：wx.setStorage/wx.getStorage 缓存不常变的数据（如城市列表/配置信息）、减少网络请求。

审核和发布

开发版：开发者自己可以测试和预览。体验版：可以分享给内部成员测试（最多 20 人）。审核版：提交给微信审核（通常 1-5 个工作日）。审核通过后可以发布上线。

版本管理：支持灰度发布（先发布给一部分用户观察效果再全量发布）。版本回滚（发现问题可以快速回退到上一个版本）。

发布前 checklist：所有页面在不同机型上测试通过、没有 console.log 残留、没有调试开关开启、隐私协议已配置、必要的资质已上传、支付功能已在真机上测试。