下载说明

云开发控制台暂不支持批量下载，如需批量下载文件或文件夹，需要首先安装 CloudBase CLI 工具并使用批量下载功能。

重点：在本地使用 vscode 打开文件夹，打开终端，然后开始下边步骤：

1.安装 Node.js

安装 Node.js，版本必须为 8.6.0+。

2 安装 CloudBase CLI 工具

使用 NPM 进行安装。

npm i -g @cloudbase/cli

3 获取云开发授权

您需要先从浏览器登录您的腾讯云账号，在获取到您的授权之后，Cloudbase CLI 才能操作您的资源。

tcb login

这个命令在终端运行后，会跳转到浏览器授权页面，授权完成后回到终端继续完成后续操作。

4 下载文件

您可以使用下面的命令下载文件/文件夹。

• 下载文件
  tcb storage download cloudPath localPath

• 下载文件夹
  下载文件夹时，需要指定--dir参数
  tcb storage download cloudPath localPath --dir

• 下载全部文件
  tcb storage download / localPath --dir

示例

以下是我在vscode完成下载的记录：

PS D:\Documents\Code\my-site> cnpm i -g @cloudbase/cli

PS D:\Documents\Code\my-site> tcb login

CloudBase CLI 2.12.2
√ 登录成功！
– 查看命令使用介绍

  $ tcb -h


PS D:\Documents\Code\my-site> tcb -h

  命令
    ai             -- [cmd]                      开启 AI 原生开发
    login             [options]                  登录腾讯云账号
    logout                                       登出腾讯云账号
    env               [cmd]                      环境管理操作
    fn                [cmd]                      操作函数
    hosting           [cmd]                      静态托管资源管理操作
    storage           [cmd]                      云存储资源管理操作
    service           [cmd]                      HTTP 访问服务管理操作
    cloudrun          [cmd]                      云托管服务管理操作`
 
 
  选项

    --verbose                                  打印出内部运行信息
    -r, --region <region>                      指定环境地域
    --mode <mode>                              指定加载 env 文件的环境
    --config-file <path>                       指定配置文件路径
    -v, --version                              输出当前版本
    -h, --help                                 查看命令帮助信息 
 
  Tips:

    – 登录

      $ tcb login

    – 使用 AI 全栈开发部署

      $ tcb ai

PS D:\Documents\Code\my-site> tcb storage -h
CloudBase CLI 2.12.2
Usage: tcb storage [options] [command]

Options:
  -h, --help                                  输出帮助信息

Commands:
  upload [options] <localPath> [cloudPath]    上传文件/文件夹
  download [options] <cloudPath> <localPath>  下载文件/文件夹，文件夹需指定 --dir 选项
  delete [options] [cloudPath]                删除文件/文件夹，文件夹需指定 --dir 选项
  list [options] [cloudPath]                  获取文件存储的文件列表，不指定路径时获取全部文件列表
  url [options] <cloudPath>                   获取文件临时访问地址
  detail [options] <cloudPath>                获取文件信息
  get-acl [options]                           获取文件存储权限信息
  set-acl [options]                           设置文件存储权限信息
  help [command]                              查看命令帮助信息

PS D:\Documents\Code\my-site> tcb storage list -e 云开发ID

┌──────┬───────────────────────────────────┬─────────────────────┬──────────────────────────────────────┬──────────┐
│ 序号 │                Key                │    LastModified     │                 ETag                 │ Size(KB) │
├──────┼───────────────────────────────────┼─────────────────────┼──────────────────────────────────────┼──────────┤
│  1   │         imgs/01.jpg         │ 2026-02-25 15:46:09 │ "e0dbcd3421e27e94b5547ccba7a9fe8f-2" │ 1812.14  │
├──────┼───────────────────────────────────┼─────────────────────┼──────────────────────────────────────┼──────────┤

PS D:\Documents\Code\my-site> tcb storage download imgs/ imgs/ --dir -e 云开发ID

CloudBase CLI 2.12.2
试试 tcb ai 命令，开启 AI 原生开发
√ 下载文件夹成功！
PS D:\Documents\Code\my-site> 

至此，指定文件夹的所有文件都会下载到本地。

(>^ω<)