# gt: General Translation CLI tool: 全局选项
URL: https://generaltranslation.com/zh/docs/cli/reference/global-options.mdx
---

title: 全局选项
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_LOG_FORMAT=json` 时，静默模式会将控制台日志级别提高到 `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
```

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

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

| 变量              | 描述                            | 值                                | 默认值       |
| --------------- | ----------------------------- | -------------------------------- | --------- |
| `GT_LOG_LEVEL`  | 输出到控制台的最低日志级别。                | `debug`, `info`, `warn`, `error` | `info`    |
| `GT_LOG_FORMAT` | 控制台输出格式。使用 `json` 可生成机器可读的日志。 | `default`, `json`                | `default` |
| `GT_LOG_FILE`   | 将完整日志写入此文件路径。                 | 文件路径                             | —         |

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

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

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