2. 环境准备:注册小程序账号、开通云开发、创建第一个云开发项目

好,咱们正式开始动手了。这一章说白了就是「搭台子」——把开发环境准备好。我见过不少新手卡在这一步,要么账号注册出问题,要么云开发开通失败。别急,跟着我的节奏一步步来,半小时内你就能跑起来第一个云开发项目。

2.1 注册小程序账号

首先,你得有个微信小程序账号。这玩意儿是免费的,但流程上有点小坑。

打开微信公众平台官网(mp.weixin.qq.com),点击右上角的「立即注册」。在类型选择里,记得选「小程序」,别选成「服务号」或「订阅号」——我刚开始就犯过这错,注册完发现不对,又得重新来。

注册流程分三步:

  1. 填写邮箱和密码——用没注册过微信公众平台的邮箱,一个邮箱只能绑定一个小程序。
  2. 激活邮箱——去邮箱里点链接,这一步很简单。
  3. 填写主体信息——个人开发者选「个人」,企业开发者选「企业」。个人注册只需要身份证信息,企业需要营业执照。
我的小建议:个人开发者注册时,身份证照片一定要拍清晰,四角完整。我有个学员因为照片反光,审核被拒了三次,白白浪费了两天时间。

提交后,审核通常几分钟到几小时不等。个人账号一般很快,我最快一次5分钟就通过了。

2.2 获取 AppID

账号注册成功后,登录后台,在「开发」->「开发设置」里,你能看到一个小程序 AppID。这东西很重要,相当于你小程序的身份证号。后面创建项目、调用云开发API,全都离不开它。

重要提醒:AppID 是敏感信息,别随便发到公开场合。我曾经在GitHub上不小心提交了包含AppID的代码,结果被人拿去乱调用,白白消耗了我的云资源配额。

2.3 开通云开发

有了账号和AppID,接下来就是开通云开发环境。这一步很多人会忽略,以为装了开发者工具就能直接用云开发——其实不是的。

在微信公众平台后台,左侧菜单找到「云开发」->「云开发环境」,点击「开通」。这时候会让你选择环境名称,我建议用 prod(生产环境)和 dev(开发环境)来命名。个人习惯是先用 dev 做测试,稳定了再创建 prod

开通时要注意:

  • 每个小程序账号可以创建两个环境(基础版)
  • 环境一旦创建,名称不能修改
  • 免费额度足够个人学习和小型项目使用
避坑指南:我曾经帮一个朋友排查问题,发现他开通云开发后一直报错「环境不存在」。折腾了半天,才发现他开通的是「微信云托管」,不是「云开发」。这两个名字很像,但完全是两回事。云开发是数据库+存储+云函数那一套,别选错了。

2.4 下载并安装开发者工具

账号和环境都准备好了,接下来装开发工具。去微信开发者工具官网下载最新版。我个人推荐下载「稳定版」,别追「预览版」——预览版有时候会有奇怪的bug,影响学习心情。

安装过程很简单,一路下一步就行。Windows用户注意安装路径别带中文,Mac用户直接拖到Applications文件夹。

2.5 创建第一个云开发项目

工具装好了,咱们来创建第一个项目。打开开发者工具,点击「新建项目」:

  1. 项目名称——随便起,比如 my-cloud-app
  2. 目录——选一个你记得住的位置,别放桌面,也别放C盘
  3. AppID——填刚才获取的那个
  4. 开发模式——选「小程序」
  5. 后端服务——这里要选「微信云开发」

点击确定后,工具会自动生成一个带云开发模板的项目。你会看到左侧有 cloudfunctions 文件夹,这就是云函数存放的地方。右侧模拟器里已经有一个简单的页面了。

嗯,这里要注意:第一次创建项目时,工具可能会提示你「未开通云开发」或「环境未初始化」。别慌,回到开发者工具左上角,点击「云开发」图标,选择你刚才在后台创建的环境,初始化一下就好了。

2.6 验证云开发是否可用

项目创建好了,怎么知道云开发真的能用了?我教你一个最简单的验证方法。

在开发者工具里,找到 cloudfunctions 文件夹,右键点击「新建云函数」,命名为 hello。工具会自动生成一个 index.js 文件,里面有一段示例代码:

// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()

// 云函数入口函数
exports.main = async (event, context) => {
  return {
    message: 'Hello from cloud!',
    time: new Date()
  }
}

右键点击这个云函数,选择「上传并部署」。部署成功后,在页面的 onLoad 里调用它:

// 在页面的 js 文件中
Page({
  onLoad() {
    wx.cloud.callFunction({
      name: 'hello',
      success: res => {
        console.log('云函数调用成功', res)
      },
      fail: err => {
        console.error('调用失败', err)
      }
    })
  }
})

打开调试器的Console面板,如果看到「云函数调用成功」和返回的数据,恭喜你——环境准备全部完成!

总结一下:注册账号 -> 获取AppID -> 开通云开发 -> 安装工具 -> 创建项目 -> 验证云函数。这六步走完,你的云开发环境就彻底准备好了。下一章咱们开始真正写代码,搭建商业后台的核心功能。

说实话,环境准备这一步最磨人。但一旦跑通了,后面就顺了。我当年第一次配环境,光AppID就找了好久,后来才发现原来藏在「开发设置」里。你现在跟着我的步骤走,应该十分钟就能搞定。