Skip to main content

模板拉取

CloudBase CLI 提供了便捷的模板拉取功能，支持内置模板、Git 仓库和子目录下载。

内置模板​

支持的模板​

  • miniprogram - 微信小程序 + CloudBase
  • react - Web 应用 - React + CloudBase
  • vue - Web 应用 - Vue + CloudBase
  • uniapp - 跨端应用 - UniApp + CloudBase
  • rules - AI 规则和配置

基本用法​

# 下载模板
tcb pull miniprogram
tcb pull react
tcb pull vue

# 指定输出目录
tcb pull miniprogram --output ./my-project

# 强制覆盖
tcb pull vue --output ./existing-project --force

# 查看可用模板
tcb pull list

云开发模板中心​

开源项目模板​

云开发模板中心提供了丰富的开源项目模板，涵盖电商、管理系统、游戏、工具等多种场景。您可以在 云开发模板中心 浏览和选择适合的开源项目模板。

使用流程​

  1. 浏览模板: 访问 云开发模板中心，在"开源项目"分类中浏览模板
  2. 获取 Git 链接: 点击感兴趣的模板，查看详情页面获取 Git 仓库链接
  3. 拉取模板: 使用 tcb pull 命令拉取模板到本地
  4. AI 开发: 使用 tcb ai 或者其他 AIIDE 开始 AI 辅助开发

示例操作​

# 1. 拉取开源项目模板
tcb pull https://github.com/example/ai-ecommerce-miniprogram

# 2. 进入项目目录
cd ai-ecommerce-miniprogram

# 3. 使用 AI CLI 开始开发
tcb ai

支持的其他 AI IDE​

如需配置其他 AI IDE，请参考 CloudBase AI ToolKit 快速开始 中的"其他 IDE 配置方式"部分，包含：

  • Cursor - 独立 IDE
  • WindSurf - 独立 IDE、VSCode、JetBrains 插件
  • CodeBuddy - VS Code、JetBrains、微信开发者工具、独立 IDE
  • 通义灵码 - 独立 IDE、VS Code、JetBrains 插件
  • 百度 Comate - VS Code、JetBrains 插件
  • GitHub Copilot - VS Code 插件
  • Claude Code - 命令行工具
  • 更多工具配置指南...

Git 仓库​

支持的格式​

  • GitHub: https://github.com/user/repo
  • Gitee: https://gitee.com/user/repo
  • SSH: git@github.com:user/repo.git

基本用法​

# 拉取整个仓库
tcb pull https://github.com/TencentCloudBase/awesome-cloudbase-examples

# 拉取子目录
tcb pull https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/overcooked-game

AI 命令集成​

在 AI 开发时直接指定模板：

# 使用 AI 命令并下载模板
tcb ai --template rules
tcb ai --template miniprogram
tcb ai --template react

错误处理​

  • 目录不为空: 系统会询问是否覆盖，或使用 --force 强制覆盖
  • Git 仓库不存在: 检查地址是否正确，确认为公开仓库
  • 网络错误: 检查网络连接后重试
  • 子目录路径无效: 确认路径和分支名称正确

注意事项​

  • Windows 系统使用 \ 分隔符，云端路径使用 / 分隔符
  • Git 子目录路径必须使用 / 分隔符
  • 建议在空目录中拉取模板