基础环境
环境管理
查看环境列表
查看所有云开发环境信息：
tcb env list
环境 ID 是环境的唯一标识，在全局范围内唯一。环境名称可自定义，用于区分不同环境。
Status 表示环境状态，只有状态正常时才可操作函数、数据库、存储等资源。新建环境可能处于初始化状态，请耐心等待。
地域说明：
- 默认展示当前地域的环境，可通过
--region <region>参数查询指定地域的环境，例如tcb env list --region ap-singapore - 标准对外地域：
ap-shanghai（上海）、ap-singapore（新加坡） ap-guangzhou（广州）按白名单提供；ap-beijing（北京）暂不提供
环境 ID 解析优先级
v3.0.0+
CloudBase CLI v3.0.0 引入了全局默认环境配置（tcb env use），环境 ID 的解析优先级为（低 → 高）：
全局配置（tcb env use）< 项目 cloudbaserc.json < 命令行 -e / --env-id
即：命令行参数 -e 始终优先，其次是项目 cloudbaserc.json，最后才是全局默认环境。
设置默认环境
v3.0.0+
设置全局默认环境 ID，设置后后续命令可省略 -e 参数：
# 设置默认环境
tcb env use <envId>
# 查看当前默认环境
tcb env use
# 清除默认环境
tcb env use --unset
修改环境别名
修改云开发环境的别名：
tcb env rename <name> -e <envId>
创建环境
v3.0.0+
创建新的云开发环境：
# 交互式创建（无参数时展示可选套餐列表）
tcb env create
# 指定参数创建
tcb env create --alias <别名> --package <套餐Id> --region ap-shanghai --duration 1
命令参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
--alias <alias> | 环境别名 | — |
--package <package> | 套餐 ID，见下方套餐列表；不填时展示套餐列表供选择 | — |
--region <region> | 环境地域 | ap-shanghai |
--duration <duration> | 购买时长（月），可选值：1-12、24 | 1 |
--auto-renew | 开启自动续费 | 否 |
--yes | 非交互模式，跳过确认提示 | — |
套餐 ID 参考：
| 套餐 ID | 套餐名称 | 适用场景 |
|---|---|---|
baas_personal | 个人版 | 新手入门，高性价比 |
baas_pf_standard | 标准版 | 小团队 |
baas_pf_enterprise | 企业版 | 中小企业 |
套餐价格与详细配额请参考 云开发定价页面。
变更套餐
v3.0.0+
变更环境套餐（升降配）：
# 交互式变更（只输入 envId 时展示可变更套餐列表）
tcb env modify -e <envId>
# 指定目标套餐
tcb env modify --package <套餐Id或编号> -e <envId>
| 参数 | 说明 |
|---|---|
--package <package> | 目标套餐 ID 或编号（套餐 ID 同上方套餐列表；不填时展示可变更套餐列表） |
-e, --env-id <envId> | 云开发环境 ID |
--yes | 跳过确认提示 |
续费环境
v3.0.0+
续费云开发环境：
tcb env renew -e <envId>
# 指定续费时长
tcb env renew --duration 3 -e <envId>
| 参数 | 说明 | 默认值 |
|---|---|---|
--duration <duration> | 续费时长（月） | 1 |
-e, --env-id <envId> | 云开发环境 ID | — |
--yes | 跳过确认提示 | — |
销毁环境
v3.0.0+
销毁云开发环境（不可恢复，请谨慎操作）：
tcb env delete -e <envId>
# 预览销毁影响范围（不实际执行）
tcb env delete -e <envId> --dry-run
# 跳过确认
tcb env delete -e <envId> --yes
命令参数:
| 参数 | 说明 |
|---|---|
-e, --env-id <envId> | 环境 ID（必填） |
--yes | 跳过确认提示 |
--dry-run | 模拟运行，仅展示环境信息和影响范围，不实际执行销毁 |
注意
销毁环境会删除该环境下的所有资源（云函数、数据库、存储等），操作不可恢复。建议先使用 --dry-run 预览。
查看环境资源配置详情
查看环境下各资源（数据库、存储、云函数、静态托管、日志服务）的唯一标识和配置：
tcb env detail -e <envId>
输出示例：
🔧 资源配置
📦 数据库 [未开通]
📁 对象存储 Bucket: 7072-prod-xxx-1326375956 地域: ap-shanghai
⚡ 云 函数 [未开通]
🌐 静态托管 [未开通]
📊 日志服务 [未开通]
与 env usage / env info 的区别：
| 命令 | 查看内容 |
|---|---|
tcb env detail | 环境配置了哪些资源（唯一标识、地域等） |
tcb env usage | 资源用量汇总 |
tcb env info | 资源指标明细（按时间范围） |
地域说明：环境归属特定地域，查询结果为空或提示「环境不存在」时，可能是地域不匹配，可通过 -r <region> 指定地域后重试，例如 tcb env detail -e <envId> -r ap-singapore。
查看资源用量
v3.0.0+
查看环境资源使用详情：
tcb env usage -e <envId>
查看资源指标明细
v3.0.0+
查看环境资源指标用量明细，支持按时间范围过滤：
tcb env info -e <envId>
# 指定时间范围
tcb env info -e <envId> --start-date 2025-01-01 --end-date 2025-01-31
| 参数 | 说明 |
|---|---|
--start-date <date> | 开始日期，格式 YYYY-MM-DD |
--end-date <date> | 结束日期，格式 YYYY-MM-DD |
-e, --env-id <envId> | 云开发环境 ID |
--yes | 跳过确认提示 |
安全域名管理
提示
安全域名管理已迁移到独立的 tcb cors 命令，功能更完整。建议使用新命令，详见 安全域名管理。
以下命令仍可用（兼容保留）：
查看安全域名
tcb env domain list -e <envId>
添加安全域名
tcb env domain create <domain> -e <envId>
删除安全域名
tcb env domain delete -e <envId>
命令速查
| 命令 | 说明 | 版本 |
|---|---|---|
tcb env list | 查看环境列表 | v1+ |
tcb env use <envId> | 设置全局默认环境 | v3.0.0+ |
tcb env use --unset | 清除全局默认环境 | v3.0.0+ |
tcb env rename <name> | 修改环境别名 | v1+ |
tcb env create | 创建新环境 | v3.0.0+ |
tcb env modify | 变更环境套餐 | v3.0.0+ |
tcb env renew | 续费环境 | v3.0.0+ |
tcb env delete | 销毁环境 | v3.0.0+ |
tcb env detail | 查看环境资源配置详情 | v3.0.0+ |
tcb env usage | 查看资源用量 | v3.0.0+ |
tcb env info | 查看资源指标明细 | v3.0.0+ |