2、开发环境搭建:注册支付宝开发者账号、下载并安装小程序开发者工具、创建你的第一个项目

说实话,很多初学者卡在第一步——环境搭建。我见过太多人,代码写得挺溜,结果连开发者工具都打不开。别急,咱们一步步来。

2.1 注册支付宝开发者账号

你得先有个支付宝账号,这个不用我教吧?但注意,个人账号和企业账号权限差别很大。我个人习惯用企业账号开发,因为能用到更多高级API。

注册步骤:

  1. 打开支付宝开放平台(open.alipay.com)
  2. 点击「立即入驻」
  3. 选择「开发者入驻」
  4. 填写基本信息,完成实名认证

嗯,这里要注意:实名认证需要绑定银行卡。我曾经帮一个朋友注册,他绑了张二类卡,结果审核卡了两天。建议用一类卡,秒过。

小技巧:注册完成后,记得去「账号中心」完善开发者资料。尤其是「应用类型」选「小程序」,别选成「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」了。下一章咱们开始写真正的业务代码。