支付宝小程序
支付宝小程序是蚂蚁集团在支付宝 App 内的原生小程序平台——隶属支付宝开放平台(open.alipay.com),文档在 opendocs.alipay.com/mini。它的整体范式高度类似微信小程序:同样是双线程模型(渲染层 AXML/ACSS + 逻辑层 JS)、同样数据驱动(setData 改数据、视图自动更新)、同样用 App() / Page() / Component() 注册。但文件后缀、标签指令、API 前缀、事件命名处处不同——.axml/.acss(不是 .wxml/.wxss)、指令前缀 a:(不是 wx:)、API 前缀 my.*(不是 wx.*)、事件用驼峰 onTap/catchTap(不是 bindtap/catchtap),且 my.* 默认不返回 Promise。因此从微信迁移「成本低但非零」,而吃透这些差异正是掌握支付宝小程序的核心。它生态偏电商 / 支付 / 金融 / 生活服务,与支付宝账户、花呗、信用体系直连——支付是它相对微信的天然优势;注册主体仅限企业。
概述
- 定位:支付宝 App 内的原生小程序,用户扫码 / 搜索 / 卡片即达、无需安装。开发者写四类文件(结构 / 样式 / 逻辑 / 配置),在支付宝客户端运行时里跑。范式类微信小程序,但后缀 / 指令 / API / 事件命名全不同——「像但不是」是第一认知。
- 四文件与结构:页面由
.axml(结构,对应微信.wxml)、.acss(样式,对应.wxss,含rpx单位)、.js(逻辑)、.json(配置)组成;全局层为app.js/app.json/app.acss。视图指令前缀a:(a:if/a:for),数据绑定用 Mustache 双花括号。 - 事件与 API(重点差异):事件绑定用
on+ 驼峰(冒泡)/catch+ 驼峰(阻止冒泡),如onTap/catchTap;API 统一前缀my.*(my.request/my.navigateTo/my.setStorage……)。关键差异:my.*默认不返回 Promise,须走success/fail回调,或自行封装 promisify(微信wx.*省略success时自动返回 Promise)。 - 登录与支付(生态核心):登录用
my.getAuthCode(auth_base静默 /auth_user主动授权)拿authCode→ 服务端alipay.system.oauth.token换user_id;支付用my.tradePay——服务端alipay.trade.create下单得交易号,前端唤起收银台,resultCode为'9000'表示成功(须服务端最终对账)。 - 运行环境与生态:运行在非浏览器环境(无
document/window/XMLHttpRequest),支持 ES2015 模块与npm install;注册仅企业;跨端主流用 Taro / uni-app(多端一码),容器技术可经 mPaaS 输出到企业自有 App。
本叶地图
- 入门 —— 支付宝小程序是什么、与微信小程序 / Web 的关系、开发者工具起步、第一个页面、心智地图
- 结构与四文件 ——
.axml/.acss/.js/.json职责、全局 vs 页面文件、a:if/a:for指令、Mustache 绑定、rpx、SJS - 事件与 API ——
onTap/catchTap驼峰事件、dataset、my.*API 调用约定、默认不返回 Promise 与 promisify 封装 - 登录与支付 ——
my.getAuthCode(auth_base / auth_user)+ 服务端换user_id、my.tradePay支付四步、resultCode与对账纪律 - 对比微信小程序 —— 后缀 / 前缀 / 指令 / 事件 / Promise / 组件 / 登录 / 支付 / 注册主体 全面差异对照
- 参考 —— 四文件 / 指令 / 事件 / my.* API / 登录 / 支付 / 宝信差异 等速查表 + 权威链接
文档地址
- 支付宝小程序官方文档 —— 框架、组件、API 一手文档
- 框架概述 —— 四文件、App / Page / Component、AXML / ACSS、事件系统
- 组件 ——
view/text/button等基础与开放组件参考 - API ——
my.*基础 API 与开放能力 API 全集 - 用户授权 my.getAuthCode ——
authCode换user_id官方流程 - 小程序唤起支付 my.tradePay —— 服务端下单 + 前端唤起收银台
- 支付宝开放平台 —— 账号注册、能力开通、服务端 OpenAPI
- 支付宝小程序开发者工具(IDE) —— 官方 IDE,编写 / 调试 / 预览 / 上传