> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 用 CLI 管理 workspace

> 用 squarecloud workspace 创建、查看、退出和删除 Square Cloud workspace，并选择每个 workspace 能看到你的哪些应用。

workspace 用于与团队共享应用。`squarecloud workspace` 也可以写作 `squarecloud ws`。每个命令都需要 workspace ID，`workspace list` 和 `workspace create` 会打印它。要添加成员，请参阅 [Workspace 成员](/zh/cli-reference/workspace-members)；帮助中心说明了[每个成员可以做什么](https://help.squarecloud.app/en-us/article/workspace-permissions-collaborators-12ahei1/)。

## `squarecloud workspace create`

```bash 用法 theme={"system"}
squarecloud workspace create <name>
```

创建一个 workspace 并打印其 ID。

```bash theme={"system"}
squarecloud workspace create "My Team"
```

```bash 输出 theme={"system"}
✓ Workspace My Team (<workspaceID>) created successfully
```

## `squarecloud workspace list`

```bash 用法 theme={"system"}
squarecloud workspace list [--json]
```

显示你拥有或加入的每个 workspace 的名称、workspace ID、成员数、应用数和创建日期。

## `squarecloud workspace info`

```bash 用法 theme={"system"}
squarecloud workspace info <workspaceID> [--json]
```

显示 workspace 的 ID、名称、拥有者和创建日期，随后是成员表（名称、成员 ID、权限组和加入日期），以及共享应用表（名称、应用 ID、语言和内存，如果有的话）。

## `squarecloud workspace app add`

```bash 用法 theme={"system"}
squarecloud workspace app add <workspaceID> <appID>
```

把你的一个应用共享给你拥有的 workspace，让其成员可以操作它。一个 workspace 最多可容纳 100 个应用。

## `squarecloud workspace app remove`

```bash 用法 theme={"system"}
squarecloud workspace app remove <workspaceID> <appID>
```

停止与 workspace 共享该应用。只有 workspace 拥有者可以执行此操作。

## `squarecloud workspace leave`

```bash 用法 theme={"system"}
squarecloud workspace leave <workspaceID> [-y]
```

| 标志 | 说明 |
| - | - |
| `-y`, `--yes` | 跳过确认提示。 |

在 `y/N` 确认后，让你退出他人拥有的 workspace。workspace 本身会保留。拥有者不能退出自己的 workspace：请改为删除它。

## `squarecloud workspace delete`

```bash 用法 theme={"system"}
squarecloud workspace delete <workspaceID> [-y]
```

| 标志 | 说明 |
| - | - |
| `-y`, `--yes` | 跳过确认提示。 |

<Warning>
  删除 workspace 是永久性的：其成员列表和应用共享设置都会一并删除。应用本身会保留在各自拥有者的账户中。
</Warning>

只有拥有者可以删除 workspace。该命令会先要求 `y/N` 确认。

## 相关内容

| 命令 | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `create` | [`POST /v2/workspaces`](/zh/api-reference/endpoint/workspace/create) | [`api.workspaces.create()`](/zh/sdks/js/workspaces) | [创建工作区](/zh/vscode-extension/features#workspace) |
| `list` | [`GET /v2/workspaces`](/zh/api-reference/endpoint/workspace/list) | [`api.workspaces.list()`](/zh/sdks/js/workspaces) | [Workspace 部分](/zh/vscode-extension/features#workspace) |
| `info` | [`GET /v2/workspaces/{workspaceId}`](/zh/api-reference/endpoint/workspace/get) | [`api.workspaces.get()`](/zh/sdks/js/workspaces) | |
| `app add` | [`POST .../applications`](/zh/api-reference/endpoint/workspace/apps/add) | [`api.workspaces.apps.add()`](/zh/sdks/js/workspaces) | |
| `app remove` | [`DELETE .../applications`](/zh/api-reference/endpoint/workspace/apps/remove) | [`api.workspaces.apps.remove()`](/zh/sdks/js/workspaces) | |
| `leave` | [`DELETE /v2/workspaces/leave`](/zh/api-reference/endpoint/workspace/leave) | [`api.workspaces.leave()`](/zh/sdks/js/workspaces) | [离开](/zh/vscode-extension/features#workspace) |
| `delete` | [`DELETE /v2/workspaces`](/zh/api-reference/endpoint/workspace/delete) | [`api.workspaces.delete()`](/zh/sdks/js/workspaces) | [删除](/zh/vscode-extension/features#workspace) |