# gt: General Translation CLI tool: 全局选项
URL: https://generaltranslation.com/zh/docs/cli/reference/global-options.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 用于控制 General Translation CLI 的输出、兼容性检查和命令帮助。全局 CLI 选项的 API 参考。

全局选项适用于 `gt` 命令及其子命令。`--quiet` 选项可位于子命令之前或之后。

## 概览 [#overview]

```bash
npx gt [global options] <command>
```

| 选项                                                            | 说明                     | 类型        | 可选 | 默认值     |
| ------------------------------------------------------------- | ---------------------- | --------- | -- | ------- |
| [`--skip-version-check`](#skip-version-check)                 | 跳过 monorepo 中包版本一致性检查。 | `boolean` | 是  | `false` |
| [`--suppress-id-compatibility-warning`](#suppress-id-warning) | 隐藏 React 包 ID 兼容性警告。   | `boolean` | 是  | `false` |
| [`-q, --quiet`](#quiet)                                       | 不输出信息性日志。              | `boolean` | 是  | `false` |
| [`-h, --help`](#help)                                         | 显示当前命令的帮助信息。           | `boolean` | 是  | `false` |

## `--skip-version-check` [#skip-version-check]

**类型** `boolean` · **可选** · **默认值** `false`

跳过对 monorepo 中 General Translation 包进行一致性检查。其他验证仍会执行。要使每个命令都保持此行为，请在 `gt.config.json` 中设置 `"skipVersionCheck": true`。

## `--suppress-id-compatibility-warning` [#suppress-id-warning]

**类型** `boolean` · **可选** · **默认值** `false`

隐藏有关 React 包 ID 行为不兼容的警告。不会更改包版本或翻译行为。

## `-q, --quiet` [#quiet]

**类型** `boolean` · **可选** · **默认值** `false`

不显示横幅、进度旋转指示器和信息性日志。警告和错误仍会显示。此选项不会屏蔽命令数据：[`gt api-key create`](/docs/cli/reference/commands/api-key-create) 仍会将新的密钥写入 stdout。

当 `GT_LOG_FORMAT` 为 `json` 或 `agent` 时，静默模式会将控制台日志级别提高到 `warn`。它不会降低限制更严格的 `GT_LOG_LEVEL`，例如 `error`。

它也适用于嵌套子命令，且可放在任意位置。

```bash
npx gt translate --quiet
npx gt git setup --quiet
```

*注意：静默模式只会抑制日志，不会禁用交互。提示仍会出现，因此以非交互方式运行命令时，请传入该命令所需的选项。*

## `-h, --help` [#help]

**类型** `boolean` · **可选** · **默认值** `false`

显示用法、选项和可用的子命令，但不会执行该命令。

```bash
npx gt translate --help
```

## API 环境变量 [#api-url]

`GT_API_URL` 用于设置所有命令使用的 API 源地址。它会覆盖 `gt.config.json` 中的 [`baseUrl`](/docs/cli/reference/config#base-url)；若两者均未设置，CLI 将使用 `https://api.gtx.dev`。值为空时视为未设置。

```bash
GT_API_URL=https://api.example.com npx gt translate
```

## 日志环境变量 [#logging]

这些环境变量用于配置 CLI 日志记录，适用于所有命令。

| 变量              | 描述             | 值                                | 默认值                                           |
| --------------- | -------------- | -------------------------------- | --------------------------------------------- |
| `GT_LOG_LEVEL`  | 输出到控制台的最低日志级别。 | `debug`, `info`, `warn`, `error` | `info`                                        |
| `GT_LOG_FORMAT` | 控制台输出格式。       | `default`, `json`, `agent`       | 在终端中为 `default`；在 CI 中或 stdout 不是终端时为 `agent` |
| `GT_LOG_FILE`   | 将完整日志写入此文件路径。  | 文件路径                             | —                                             |

`default` 为交互式显示，包含 ASCII 横幅和 CLI 版本行。`json` 每行输出一个 JSON 日志对象。`agent` 输出带时间戳的纯文本 `LEVEL: message` 行，不带颜色，也不显示横幅。`json` 同样不显示横幅。

自 `gt` 2.26.10 起，若未设置 `GT_LOG_FORMAT`，则在 stdout 不是终端时，或 `CI` 非空且既不是 `false` 也不是 `0` 时，默认使用 `agent`。如需在这些环境中保留交互式显示，请设置 `GT_LOG_FORMAT=default`。

`GT_LOG_FILE` 是一项用于捕获调试日志的显式启用选项，[`--quiet`](#quiet) 不会影响它。即使静默控制台，仍可在磁盘上保留完整日志：

```bash
GT_LOG_FILE=gt.log npx gt translate --quiet
```

对于 [`gt api-key create`](/docs/cli/reference/commands/api-key-create)，诊断信息会输出到 stderr。即使启用了 JSON 日志记录，密钥仍会以原始文本形式直接输出到 stdout，且绝不会被 `GT_LOG_FILE` 捕获。

*注意：`GT_LOG_FORMAT` 或 `GT_LOG_LEVEL` 的值无效时，命令会报错并停止执行。*

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.