3、开通云开发:在开发者工具中开通云开发、创建云开发环境、理解环境ID的概念
好,咱们接着往下走。上一节我们把开发者工具装好了,项目也创建了。现在要干正事了——开通云开发。
这一步其实很简单,但很多人会在这里卡住。我见过不少新手,项目建了一堆,结果发现云开发没开通,调接口全是报错。嗯,咱们别走这个弯路。
3.1 在开发者工具中开通云开发
打开你的开发者工具,找到工具栏上那个「云开发」按钮。它长什么样?一个云朵图标,旁边写着「云开发」。点它。
第一次点进去,会弹出一个开通确认框。说白了就是微信要跟你确认:你真的要用云开发吗?
这里要注意一点:开通云开发需要你有一个已认证的小程序AppID。如果你用的是测试号,那不好意思,这条路走不通。我个人习惯是,项目一开始就用真实AppID,省得后面折腾。
重要提醒:开通云开发是免费的,但每个环境会赠送一定的免费额度。超出部分才收费。对于学习和个人项目,免费额度完全够用。
点击「开通」之后,微信会跳转到一个协议页面。大致内容就是:你同意使用微信云开发服务,遵守相关规则。没什么好犹豫的,勾上同意,点确定。
等个几秒钟,云开发就开通成功了。你会看到一个全新的界面——云开发控制台。
3.2 创建云开发环境
开通之后,第一件事是什么?创建环境。
云开发控制台里,你会看到一个「新建环境」的按钮。点它。
这时候需要填两个东西:
- 环境名称:给你的环境起个名字。比如「test」、「dev」、「prod」都行。我个人习惯用「dev-项目名」这种格式,方便区分。
- 环境ID:系统会自动生成一个唯一ID。这个ID很重要,后面会反复用到。
创建环境大概需要1-2分钟。微信后台会帮你初始化数据库、存储、云函数这些基础设施。你想想看,要是自己搭服务器,光配数据库就得半天。云开发一键搞定,确实省心。
小技巧:一个账号最多可以创建两个环境。我建议你一个用来开发测试,一个用来正式上线。千万别在正式环境里瞎折腾,我曾经吃过这个亏——测试数据把线上用户数据搞乱了,恢复起来特别麻烦。
3.3 理解环境ID的概念
环境ID是什么?说白了,它就是你的云开发环境的「身份证号」。
每个环境都有一个唯一的ID。这个ID由字母和数字组成,比如 test-123abc 这种格式。你在代码里调用云开发的各种功能时,都需要指定这个ID。
为什么会这样设计?因为一个账号可以有多个环境。环境ID就是用来区分它们的。比如:
| 环境名称 | 环境ID | 用途 |
|---|---|---|
| 开发环境 | dev-abc123 | 日常开发、调试 |
| 测试环境 | test-def456 | 功能测试、联调 |
| 生产环境 | prod-ghi789 | 正式上线使用 |
你在代码里调用云数据库时,会这样写:
// 初始化云开发环境
wx.cloud.init({
env: 'dev-abc123' // 这里填你的环境ID
})
// 调用数据库
const db = wx.cloud.database()
db.collection('users').get().then(res => {
console.log(res.data)
})
看到没?env 参数里填的就是环境ID。如果你不填,默认使用第一个创建的环境。但我建议你每次都显式指定,避免搞混。
避坑指南:我曾经在项目里忘记改环境ID,结果开发环境的数据写到了生产环境。用户看到一堆测试数据,差点被投诉。从那以后,我每次切换环境都会检查三遍环境ID。
3.4 环境ID的获取方式
环境ID在哪里找?很简单:
- 打开开发者工具的「云开发」控制台
- 在左上角能看到当前环境的名称和ID
- 点击环境名称旁边的下拉箭头,可以切换不同环境
- 每个环境的ID都会显示在名称下方
还有一种方式:在项目配置文件 project.config.json 里也能找到。不过我个人习惯直接去控制台复制,更直观。
3.5 小结
嗯,这一节的内容其实不多,但很重要。开通云开发、创建环境、理解环境ID,这三步是后续所有操作的基础。
你想想看,如果环境ID搞错了,后面写的所有代码都可能跑偏。所以我的建议是:创建环境时就把ID记下来,贴到项目文档里。别嫌麻烦,后面你会感谢自己的。
下一节,咱们开始真正写代码——初始化云开发、调用第一个云函数。准备好了吗?