必须完成支付宝备案和开发工具配置，manifest.json中mp-alipay节点需正确填写真实AppID及permission权限，HBuilderX须手动指定AlipayIDE.exe路径，编译后需在支付宝IDE中手动添加项目并上传，上传成功后仍需在开放平台提交审核。
直接上手就能发，不需要额外注册公司或买服务器，但必须完成支付宝开放平台备案和开发工具配置，否则编译后无法上传。
manifest.json 里填对 mp-alipay 配置项
这是最常卡住的一步：HBuilderX 编译支付宝小程序时，只认 manifest.json 中 mp-alipay 节点下的字段，其他地方写的 appid 全无效。
-
appid必须填你支付宝开放平台创建小程序后分配的真实 AppID，不能是测试号或占位符 - 如果用到了摄像头、相册等能力，得在
permission数组里显式声明，比如：{"scope": "scope.camera", "desc": "用于人脸识别"} - 不填
permission会导致真机调试时弹不出授权框，且控制台无报错，只静默失败 - 注意 JSON 格式要合法——
mp-alipay是顶层 key，不是嵌套在h5或mp-weixin下面
HBuilderX 设置里指定支付宝开发工具路径
uni-app 不会自动找开发工具位置，必须手动告诉它。路径错了，点击「发行 → 支付宝小程序」后会提示“未检测到支付宝 IDE”或直接卡在“正在启动工具”。
- 打开 HBuilderX → 工具 → 设置 → 运行配置 → 支付宝小程序开发工具路径
- 路径要精确到可执行文件：Windows 是
AlipayIDE.exe，macOS 是AlipayIDE.app/Contents/MacOS/AlipayIDE - 别选错成微信开发者工具或旧版“支付宝小程序开发者工具（已下线）”
- 改完路径后重启 HBuilderX 才生效，不重启设置不加载
编译后要在支付宝 IDE 里手动添加项目再上传
uni-app 的「发行 → 支付宝小程序」只是生成代码包并自动打开 IDE，不会自动导入项目。很多人以为点完就完了，结果在 IDE 里看不到项目，也传不了。
- 编译完成后，IDE 启动但空白，此时需点击左上角「添加项目」→ 选择输出目录（默认是
unpackage/dist/build/mp-alipay） - 项目根目录必须包含
apppid文件（由 uni-app 自动生成），否则 IDE 拒绝识别为合法小程序 - 添加成功后双击打开，确认右上角显示的是你的 AppID，不是
undefined或空值 - 上传前务必点右上角「清缓存并重新编译」，否则可能上传旧版本代码
上传成功 ≠ 可上线，备案和审核缺一不可
很多开发者上传成功就以为搞定了，结果在开放平台找不到提交入口，或者提交后秒拒——问题出在账号状态没达标。
- 个人开发者也能发布，但必须完成「小程序备案」，仅注册开放平台账号不够；备案时证件类型选身份证即可，不用营业执照
- 备案审核通常 1–3 个工作日，期间无法提交审核，状态在「支付宝开放平台 → 小程序管理 → 备案中心」查看
- 上传代码后，要进开放平台 → 控制台 → 管理 → 版本管理 → 开发管理，才能看到刚上传的版本并点击「提交审核」
- 审核被拒最常见的原因是域名未备案、
request请求域名没加白名单、或隐私政策弹窗缺失
最容易被忽略的是：支付宝 IDE 上传用的是本地代码，而开放平台审核看的是线上版本，两者不同步就会白忙一场；每次改完代码，必须重新编译 → 添加项目 → 上传 → 再去开放平台提交新版本审核。
