> ## 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 查看应用日志

> 用 squarecloud app logs 打印 Square Cloud 应用的最新日志，或用 app realtime 在终端中实时跟踪输出和状态变化。

`[appID]` 是可选的：参见 [CLI 如何找到你的应用](/zh/cli-reference/quickstart#cli-如何找到你的应用)。

## `squarecloud app logs`

```bash 用法 theme={"system"}
squarecloud app logs [appID] [--json]
```

打印应用最近的日志，然后退出。

```bash theme={"system"}
squarecloud app logs
# ID= 行中应用的日志，或从选择器中选一个。
```

```bash theme={"system"}
squarecloud app logs <appID> --json
# 打印 {"logs": "..."}，而不是纯文本。
```

## `squarecloud app realtime`

```bash 用法 theme={"system"}
squarecloud app realtime [appID]
```

连接到应用的实时流，并保持连接，直到你按下 `Ctrl+C`。

* 日志行会按应用写入时的原样打印。应用写入 stderr 的行会输出到 stderr，因此你可以用重定向把它们分开。
* 状态只在发生变化时以 `[status] <state>` 的形式显示。

```bash theme={"system"}
squarecloud app realtime <appID> 2> errors.log
# 实时跟踪应用，并把它的 stderr 行保存到 errors.log。
```

```bash 输出 theme={"system"}
Connected to the realtime stream of <appID> (Ctrl+C to exit)
[status] running
<log lines>
```

`realtime` 没有 JSON 输出。

## 相关内容

| 命令 | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `logs` | [`GET .../logs`](/zh/api-reference/endpoint/apps/logs) | [`api.apps.logs()`](/zh/sdks/js/managing_application) | [查看日志](/zh/vscode-extension/features#应用) |
| `realtime` | [`GET .../realtime`](/zh/api-reference/endpoint/apps/realtime) | [`api.apps.realtime()`](/zh/sdks/js/realtime) | [切换实时流](/zh/vscode-extension/features#应用) |

网站的边缘请求日志请参阅 [`squarecloud app network logs`](/zh/cli-reference/edge-analytics#squarecloud-app-network-logs)。