功能规划：明确小程序需要接入哪些核心能力

在南京开发微信小程序，第一步不是写代码，而是根据业务场景确定需要接入哪些官方功能模块。常见的接入方向包括：用户登录授权（获取OpenID和手机号）、支付接口（微信支付商户口碑配置）、地图与定位（适用于本地生活、到店服务）、消息模板（订单通知、预约提醒）以及云开发（数据库与存储）。建议先整理一张功能清单，对照微信公众平台的能力文档逐一勾选，避免后期反复调整。

注册与配置：拿到接入的前提凭证

所有代码功能接入都以小程序AppID和AppSecret为基础。注册完成后，在“开发-开发设置”中获取这两个参数。若涉及支付，还需在微信商户平台完成商户号绑定，并配置支付回调域名。注意：AppSecret一旦泄露需立即重置，切勿明文存储在代码仓库中。对于需要定位能力的项目，还应在“开发-接口设置”中申请权限，并在“服务器域名”处添加合法域名白名单。

代码接入流程：从登录到支付的核心步骤

1. 登录与用户信息获取

使用wx.login()获取临时code，发送至开发者后端换取openid和session_key。若需获取用户手机号（如医疗预约、会员注册场景），调用getPhoneNumber接口，务必在按钮触发事件中发起，且提示用户授权用途。这里要注意：手机号解密需要在后端完成，不能在前端直接处理。

2. 微信支付的接入要点

支付流程遵循“统一下单-支付调起-结果通知”三段式。前端调用wx.requestPayment前，必须确保后端已成功下单并返回了prepay_id。安全边界方面，签名算法务必放在后端执行，前端只负责调起支付。支付结果以异步通知为准，不要仅依赖前端回调做订单状态变更。

3. 地图与定位的调试技巧

在南京本地开发测试时，建议使用模拟器中的“自定义位置”功能填写南京的坐标（如新街口附近），或直接使用真机调试。接入wx.chooseLocation或wx.getLocation时，需在app.json中声明requiredLocation字段，且弹框权限描述应清晰说明用途（例如“用于查找附近的诊所”）。

常见问题与合规建议

• 登录态过期处理：用户清理缓存后session_key可能失效，建议在每次调用业务接口前检查token是否仍在有效期内。
• 支付回调域名：一定要配置HTTPS协议的公网域名，本地调试可使用内网穿透工具暂时应对。
• 用户隐私合规：自2023年起，小程序需通过“用户隐私保护指引”审核，收集手机号、位置等敏感信息时必须在app.json中填写对应使用说明。
• 权限申请陷阱：部分接口（如getUserInfo）已不再弹出授权窗口，应采用头像昵称填写能力或改用手机号快捷登录方案。

测试与上线前的检查清单

1. 确保在微信开发者工具中通过“真机测试”环节，特别是在不同版本的基础库上验证接口响应。
2. 核对所有请求是否使用了HTTPS，且域名已添加到白名单。
3. 支付环节至少测试“取消支付”“支付成功”“支付失败”三种回执，并确认后端日志能正确记录。
4. 若是南京本地服务类小程序（如景区导览、医院挂号），建议在测试阶段模拟3种以上不同手机型号的定位精度。

一个小技巧：接入初期尽量使用微信云开发快速验证功能逻辑，后期再迁移到自建服务器。云开发能帮你省去域名备案和HTTPS配置的麻烦，尤其适合南京本地中小企业快速上线第一版小程序。

功能规划：明确小程序需要接入哪些核心能力

在南京开发微信小程序，第一步不是写代码，而是根据业务场景确定需要接入哪些官方功能模块。常见的接入方向包括：用户登录授权（获取OpenID和手机号）、支付接口（微信支付商户口碑配置）、地图与定位（适用于本地生活、到店服务）、消息模板（订单通知、预约提醒）以及云开发（数据库与存储）。建议先整理一张功能清单，对照微信公众平台的能力文档逐一勾选，避免后期反复调整。

注册与配置：拿到接入的前提凭证

所有代码功能接入都以小程序AppID和AppSecret为基础。注册完成后，在“开发-开发设置”中获取这两个参数。若涉及支付，还需在微信商户平台完成商户号绑定，并配置支付回调域名。注意：AppSecret一旦泄露需立即重置，切勿明文存储在代码仓库中。对于需要定位能力的项目，还应在“开发-接口设置”中申请权限，并在“服务器域名”处添加合法域名白名单。

代码接入流程：从登录到支付的核心步骤

1. 登录与用户信息获取

使用wx.login()获取临时code，发送至开发者后端换取openid和session_key。若需获取用户手机号（如医疗预约、会员注册场景），调用getPhoneNumber接口，务必在按钮触发事件中发起，且提示用户授权用途。这里要注意：手机号解密需要在后端完成，不能在前端直接处理。

2. 微信支付的接入要点

支付流程遵循“统一下单-支付调起-结果通知”三段式。前端调用wx.requestPayment前，必须确保后端已成功下单并返回了prepay_id。安全边界方面，签名算法务必放在后端执行，前端只负责调起支付。支付结果以异步通知为准，不要仅依赖前端回调做订单状态变更。

3. 地图与定位的调试技巧

在南京本地开发测试时，建议使用模拟器中的“自定义位置”功能填写南京的坐标（如新街口附近），或直接使用真机调试。接入wx.chooseLocation或wx.getLocation时，需在app.json中声明requiredLocation字段，且弹框权限描述应清晰说明用途（例如“用于查找附近的诊所”）。

常见问题与合规建议

• 登录态过期处理：用户清理缓存后session_key可能失效，建议在每次调用业务接口前检查token是否仍在有效期内。
• 支付回调域名：一定要配置HTTPS协议的公网域名，本地调试可使用内网穿透工具暂时应对。
• 用户隐私合规：自2023年起，小程序需通过“用户隐私保护指引”审核，收集手机号、位置等敏感信息时必须在app.json中填写对应使用说明。
• 权限申请陷阱：部分接口（如getUserInfo）已不再弹出授权窗口，应采用头像昵称填写能力或改用手机号快捷登录方案。

测试与上线前的检查清单

1. 确保在微信开发者工具中通过“真机测试”环节，特别是在不同版本的基础库上验证接口响应。
2. 核对所有请求是否使用了HTTPS，且域名已添加到白名单。
3. 支付环节至少测试“取消支付”“支付成功”“支付失败”三种回执，并确认后端日志能正确记录。
4. 若是南京本地服务类小程序（如景区导览、医院挂号），建议在测试阶段模拟3种以上不同手机型号的定位精度。

一个小技巧：接入初期尽量使用微信云开发快速验证功能逻辑，后期再迁移到自建服务器。云开发能帮你省去域名备案和HTTPS配置的麻烦，尤其适合南京本地中小企业快速上线第一版小程序。