> ## 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.

# squarecloud app env

> 管理你在 Square Cloud 上应用程序的环境变量。

列出、设置、移除或替换应用的环境变量。对于 `list`，应用 ID 是可选的，CLI 会先从参数中解析，然后是 `squarecloud.app` 配置文件，最后回退到交互式选择器。对于 `set`、`remove` 和 `replace`，请改用 `--app` 传入应用 ID，因为位置参数已用于变量名。

```bash theme={null}
squarecloud app env list
# 列出 squarecloud.app 中的应用（或交互式选择器选出的应用）的环境变量。
```

```bash theme={null}
squarecloud app env list <appID> --json
# 以 JSON 格式列出指定应用的变量。
```

```bash theme={null}
squarecloud app env set KEY=VALUE ANOTHER=VALUE --app <appID>
# 设置一个或多个变量，不影响其余变量。
```

```bash theme={null}
squarecloud app env set --from-file .env --app <appID>
# 设置从 .env 风格文件中读取的变量。
```

```bash theme={null}
squarecloud app env remove KEY ANOTHER --app <appID>
# 移除一个或多个变量。别名："delete"、"unset"。
```

```bash theme={null}
squarecloud app env replace KEY=VALUE --app <appID>
# 用提供的变量替换整套变量；未列出的现有变量会被移除。
```

`replace` 子命令具有破坏性：在清空现有变量之前，它会要求 `y/N` 确认。传入 `-y`/`--yes` 可跳过该提示。

```bash theme={null}
squarecloud app env replace --from-file .env --app <appID> -y
# 从文件替换所有变量，且不询问确认。
```

使用 `squarecloud app env --help` 获取有关此命令的更多信息。