跳到主要内容

微信小程序 快速开始

准备工作​

在开始之前，请确保您已完成以下准备：

  1. 开通云开发环境：开通云开发环境
  2. 开发工具：下载并安装 微信开发者工具
  3. 小程序账号：注册微信小程序，获取小程序的 AppID

更多详情请参考：微信小程序 完整文档

添加 CloudBase AI 开发插件​

可选：如果你使用 AI 编程助手（如 Cursor、Claude Code、CodeBuddy 等）进行开发，建议先完成本步骤，让 AI 具备 CloudBase 开发能力。

复制 AI Prompt 粘贴到 AI IDE​

在 AI 对话中输入：

帮我把 CloudBase 接好，按下面做：
1. 打开 https://docs.cloudbase.net/skill.md，按说明完成接入。
2. 接入完成后告诉我，并建议最相关的下一步。

查看 skill.md →

使用 Skills 开发​

对 AI 说：

使用 CloudBase Skills：在微信小程序中集成云开发，包括数据库和云存储功能

Skills 使用文档 →

也可以手动安装 CloudBase Skills：

npx skills add tencentcloudbase/cloudbase-skills -y

初始化 SDK​

在 app.js 中初始化云开发：

原生API 初始化​

大部分云开发能力可通过 小程序原生 API 直接调用，无需安装 SDK，若 原生API 不支持请使用 Client SDK 进行调用

App({
  onLaunch() {
    wx.cloud.init({
      env: "{%ENV_ID%}"
    });
  }
});

Client SDK 初始化​

安装

使用 Client SDK 前请先安装 SDK

在小程序 package.json 所在目录（通常为 miniprogram 目录）执行：

npm i @cloudbase/wx-cloud-client-sdk --save

安装完成后，在微信开发者工具点击 工具 → 构建 npm。

初始化

const { init } = require("@cloudbase/wx-cloud-client-sdk");

App({
  onLaunch() {
    wx.cloud.init({
      env: "{%ENV_ID%}"
    });
    this.globalData.cloudbase = init(wx.cloud);
  },
  globalData: {}
});

文档型数据库​

const db = wx.cloud.database();

// 查询 {%TABLE_NAME%} 表前10条数据
const res = await db.collection("{%TABLE_NAME%}").limit(10).get();

console.log(res.data);

云存储​

wx.chooseMedia({
  count: 1,
  mediaType: ["image", "video"],
  sourceType: ["album", "camera"],
  success: async res => {
    const res = await wx.cloud.uploadFile({
      cloudPath: "images/" + Date.now() + ".png", // 上传至云端的路径
      filePath: res.tempFiles[0].tempFilePath // 小程序临时文件路径
    });

    console.log(res.fileID);
  }
});

云函数​

// 调用 {%FUNCTION_NAME%} 云函数
const res = await wx.cloud.callFunction({
  name: "{%FUNCTION_NAME%}",
  data: {} // 云函数入参
});

console.log(res.result);

大模型​

const res = await wx.cloud.extend.AI.createModel(
  "{%AI_MODEL_NAME%}"
).streamText({
  data: {
    model: "{%AI_SUB_MODEL_NAME%}",
    messages: [
      {
        role: "user",
        content: "你好"
      }
    ]
  }
});

for await (let event of res.eventStream) {
  if (event.data === "[DONE]") {
    break;
  }
  const data = JSON.parse(event.data);

  // 当使用 deepseek-r1 时，模型会生成思维链内容
  const think = data?.choices?.[0]?.delta?.reasoning_content;
  if (think) {
    console.log(think);
  }

  // 打印生成文本内容
  const text = data?.choices?.[0]?.delta?.content;
  if (text) {
    console.log(text);
  }
}