云开发开通教程：从注册账号到环境就绪全流程

摘要： 开通云开发 CloudBase 环境分两条路：做小程序从微信开发者工具建，做 Web 从云开发控制台建。全程十分钟内可完成，真正的坑不在操作，而在账号和登录方式选错，本文给出逐步操作与排查表。 按本文步骤开通环境：云开发 CloudBase

先说一个判断：如果你在开通云开发这一步卡住了，九成不是操作失误，而是账号没对齐——用了测试号、开通时选错登录方式、或者开发者工具和云开发控制台登的不是同一个腾讯云账号。这三种情况的报错都很隐蔽，不会明确告诉你「账号不对」，只会表现为按钮点不动、环境列表空白、小程序里用不了。下面按两条路径给完整操作，最后给一张能直接对照的排查表。

一、开通前先确认三件事

要点一：腾讯云账号已完成实名认证。 没实名认证，开通云开发会失败，而控制台往往只在角落给一行小字提示，很容易漏掉。先去腾讯云账号中心确认实名状态。

要点二：想清楚你要做什么端。 这决定走哪条路径，选错会返工：

• 做微信小程序或小游戏 → 走微信开发者工具创建，环境自动和小程序关联
• 做 Web 应用、H5、服务端应用 → 走云开发控制台创建
• 做平台、SaaS 多租户、要批量建环境 → 走 CreateEnv 云 API

要点三：如果做小程序，先把 AppID 准备好。 去微信公众平台注册小程序，在「开发管理 - 开发设置」里复制 AppID。不要用测试号，测试号不支持云开发。

二、首次使用：先完成服务开通授权

不管走哪条路径，初次使用云开发都要先做一次服务开通，这步只做一次。

进入云开发控制台，按页面指引勾选服务条款，完成云开发服务角色权限授权。这个授权是让云开发有权限在你的账号下创建和管理资源，不授权后面建不了环境。

授权完成后，系统会自动开通个人版免费期，直接给你一个可用的免费体验环境，同时打开云开发平台。也就是说，新用户走完授权就已经有环境了，不需要额外购买。

三、路径一：小程序开发者从微信开发者工具创建

这条路径的好处是环境自动与当前小程序关联，省掉后续绑定操作。

第 1 步：用正式 AppID 打开项目。 在微信开发者工具里新建或打开项目，确认「详情 - 基本信息」里的 AppID 是你账号下真实可用的 AppID。这里有两种错误值要避开：空 AppID、touristappid（游客模式）。这两种情况下云开发按钮不可用，后续 AI 工具也打不开项目窗口。

第 2 步：点击顶部「云开发」按钮。 按钮在开发者工具上方工具栏。如果这个按钮是灰色点不动，直接跳到第六节排查表第一行——基本可以确定你用的是测试号。

第 3 步：按提示创建环境。 首次进入会引导你创建云开发环境。这里有个关键选择：如果弹出登录方式选择，选「微信公众平台登录」，不要选腾讯云账号登录。 选微信公众平台登录，环境会自动关联当前小程序；选错了，环境能建出来，但小程序里用不了，还得回头做账号绑定。

第 4 步：等待资源初始化。 创建后需要等几分钟完成数据库、存储等资源初始化，不要以为卡住了就反复点。初始创建的环境会自动成为默认环境。

第 5 步：验收。 环境创建成功的标志是：开发者工具里能进入云开发控制台面板，能看到数据库、存储、云函数三个模块，且环境名称显示正常。此时在小程序代码里调 wx.cloud.init() 不会报「云开发未初始化」。

四、路径二：Web 开发者从云开发控制台创建

这条路径适合不做小程序的场景，操作更直接。

第 1 步：进入云开发控制台。 新用户走完第二节的授权流程后，系统已自动发放个人版免费期环境，可以直接用。

第 2 步：需要额外环境时点「新建环境」。 控制台点击「新建环境」按钮，进入环境下单页。

第 3 步：在下单页做三个选择。

• 环境名称：建议带用途和阶段，比如 myapp-dev、myapp-prod，后面环境多了好区分
• 套餐版本：先验证想法选免费或个人版，正式业务按量选标准版及以上
• 数据库类型：这里有个一次性决策——如果选 PostgreSQL，环境将以 PG 模式运行，数据库、身份认证与云存储共用一套 SQL 权限模型。注意 PG 模式仅新建环境支持，存量环境不支持升级，也就是说建完改不了，要提前想清楚

第 4 步：确认后进入云开发平台。 支付（免费套餐为 0 元）完成后即可进入平台。

第 5 步：记下环境 ID。 在控制台能看到环境名称、环境 ID（EnvId）、地域、套餐版本。环境 ID 要单独记下来，后面前端初始化 SDK、配置 AI 工具、写 cloudbaserc.json 都要用它。

五、特殊情况：小程序要用已建在腾讯云的环境

如果你先在腾讯云账号里建好了环境，现在想在小程序里用，不能直接选，要先做账号绑定。按下面五步走：

第 1 步：登录云开发控制台，在菜单栏用户名下拉菜单中点「账号信息」，进入账号中心。注意：如果你当前是子账号登录，必须切到主账号才能操作。

第 2 步：在「登录方式」里找到「微信公众平台」，点击右侧的「关联」。

第 3 步：用弹出的二维码完成微信登录，在账号关联窗口点「去授权」，按提示完成授权。

第 4 步：打开微信开发者工具，进入云开发控制台。

第 5 步：进入「设置」，下拉「环境名称」列表，点「管理我的环境」；在「环境管理」侧边栏点「使用已有腾讯云环境」，选择目标环境，确认环境转换，按提示扫码验证。

没做这步绑定时的典型表现是：云开发控制台里看不到已有环境，或者 AI 工具的连接器连上了但环境列表是空的。

六、连不上时按这张表排查

遇到问题按从上到下的顺序查，大部分卡点在前三行。

七、环境建好之后做什么

环境到手后，控制台里这几件事值得先过一遍：

看清环境基础信息：环境名称、环境 ID、地域、套餐版本，其中环境 ID 后面高频使用。

确认资源入口：数据库、云函数、云存储、云托管、静态网站托管五个模块都在环境内，这是你后面所有操作的落点。

提前看用量与计费：控制台能看调用次数、资源用量、套餐额度。云开发按天统计各环境 API 调用次数，超过 80% 和 90% 会通过微信、短信、站内信、邮件提醒，用尽后调用会报「调用次数已达上限」，隔天自动重置。先知道这个机制，比事后排查强。

多环境的规划：每个环境资源独立隔离，建议开发和生产分开建。当前微信侧可创建两个免费环境，腾讯云侧可创建一个免费环境。还有一条要注意：微信侧创建的环境支持小程序端和 Web 端，腾讯云侧创建的环境目前只支持 Web 端。

总结

开通云开发环境的操作并不复杂，关键是开头三个选择别错：实名认证先做完，做小程序就从微信开发者工具建并选微信公众平台登录，做 Web 就从控制台建并记下环境 ID；PostgreSQL 模式是建环境时的一次性决策，建完不能改。环境到手后先看一遍资源入口和用量机制，再按开发需求进入小程序、Web 或 AI 工具的开发流程。遇到连不上，别急着改代码，先对照第六节的排查表核账号。

现在开通环境，动手做你的应用：云开发 CloudBase 购买页