2、开发环境搭建:注册支付宝开发者账号、下载并安装小程序开发者工具、创建你的第一个项目
说实话,很多初学者卡在第一步——环境搭建。我见过太多人,代码写得挺溜,结果连开发者工具都打不开。别急,咱们一步步来。
2.1 注册支付宝开发者账号
你得先有个支付宝账号,这个不用我教吧?但注意,个人账号和企业账号权限差别很大。我个人习惯用企业账号开发,因为能用到更多高级API。
注册步骤:
- 打开支付宝开放平台(open.alipay.com)
- 点击「立即入驻」
- 选择「开发者入驻」
- 填写基本信息,完成实名认证
嗯,这里要注意:实名认证需要绑定银行卡。我曾经帮一个朋友注册,他绑了张二类卡,结果审核卡了两天。建议用一类卡,秒过。
小技巧:注册完成后,记得去「账号中心」完善开发者资料。尤其是「应用类型」选「小程序」,别选成「H5」了。我刚开始就选错过,后来还得重新申请。
2.2 下载并安装小程序开发者工具
工具下载地址在开放平台首页就能找到。但我要提醒你:别下错版本。支付宝小程序开发者工具有Windows版和Mac版,还有32位和64位的区别。
我个人推荐下载稳定版,别追新。为什么?因为beta版经常有bug。我记得有一次beta版更新后,模拟器直接白屏,折腾了我一上午。
避坑指南:安装路径不要有中文!我曾经把工具装到「D:\程序\支付宝开发工具」里,结果死活打不开。后来发现是中文路径的问题。改成全英文路径,一切正常。
安装完成后,打开工具。你会看到登录界面。用刚才注册的支付宝账号扫码登录。登录成功后,界面长这样:
| 区域 | 功能 |
|---|---|
| 左侧导航栏 | 项目管理、模板市场、文档中心 |
| 中间主区域 | 项目列表、新建项目入口 |
| 底部状态栏 | 工具版本、登录状态、网络连接 |
说白了,这个工具就是你的主战场。后面所有代码都在这里写。
2.3 创建你的第一个项目
好,重头戏来了。点击「新建项目」,你会看到这个界面:
项目配置:
- 项目名称:建议用英文或拼音,比如「my-first-app」
- 项目路径:选一个干净的文件夹,别跟其他项目混在一起
- AppID:先选「使用测试AppID」,后面再换正式的
- 模板:选「空白项目」,别选带demo的,容易混淆
你想想看,为什么我建议用测试AppID?因为正式AppID需要审核,而且有调用次数限制。测试环境随便玩,不心疼。
点击「确定」,工具会自动生成项目结构。你会看到这样的目录:
my-first-app/
├── app.acss # 全局样式
├── app.js # 全局逻辑
├── app.json # 全局配置
├── pages/
│ └── index/
│ ├── index.acss
│ ├── index.axml
│ ├── index.js
│ └── index.json
└── mini.project.json # 项目配置文件
嗯,这里要注意:app.json是核心配置文件。我见过有人把页面路径写错了,结果页面死活加载不出来。检查一下这个文件:
{
"pages": [
"pages/index/index"
],
"window": {
"defaultTitle": "我的第一个小程序",
"titleBarColor": "#1677FF"
}
}
保存后,点击工具栏的「预览」,用支付宝扫码就能在手机上看到效果了。是不是很简单?
个人经验:第一次预览时,手机会提示「开发版小程序」。别慌,这是正常的。点击「确定」就能进入。如果你用的是iOS,记得在「设置-通用-设备管理」里信任开发者证书。我有个同事卡在这步半小时,后来发现是证书没信任。
2.4 避坑指南(我踩过的坑)
最后,分享几个我实际项目中遇到的坑:
- 工具闪退:如果你用的是Mac,记得给工具「完全磁盘访问权限」。否则打开项目时会崩溃。我一开始不知道,重装了三次工具。
- 模拟器不刷新:改了代码但模拟器没反应?试试「清除缓存-编译」。快捷键是
Cmd+Shift+R(Mac)或Ctrl+Shift+R(Windows)。 - AppID绑定失败:如果你换了正式AppID,记得在「项目设置」里重新绑定。否则上传代码时会报错。
好了,环境搭建就到这里。你现在应该能打开工具,看到「Hello World」了。下一章咱们开始写真正的业务代码。