# Google Cloud CLI

一套命令行工具，用于管理 Google Cloud 项目、云资源和应用，适合终端操作与自动化部署。

> 这是 OpenNavo 上 Google Cloud CLI 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/gcloud-cli>

- **最新版本**: `594.0.0`
- **开发者**: Google
- **主页**: <https://cloud.google.com/cli/>
- **分类**: [开发工具](https://opennavo.com/zh/categories/developer-tools)
- **安装**: `brew install --cask gcloud-cli`
- **近 30 天安装**: 50,571
- **Homebrew**: 可以安装，应用会自行更新
- **曾用 token**: google-cloud-sdk
- **下载地址**: <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-arm.tar.gz>
- **SHA-256**: `45fbcc5a2caf9ec43847383d2f9fe4720eb8a650349be8d9bd271bdfb6912b55`
- **附带命令**: git-credential-gcloud, gsutil, bq, docker-credential-gcloud, gcloud

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 注意事项

To use additional binary components installed via gcloud, add the "$HOMEBREW_PREFIX/share/google-cloud-sdk/bin" directory to your PATH environment variable, e.g., (for Bash shell): export PATH=$HOMEBREW_PREFIX/share/google-cloud-sdk/bin:"$PATH"

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "preflight_steps": [
        {
          "steps": [
            {
              "recursive": true,
              "source": {
                "base": "staged_path",
                "path": "google-cloud-sdk/."
              },
              "target": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk"
              },
              "type": "copy"
            },
            {
              "paths": [
                {
                  "base": "staged_path",
                  "path": "google-cloud-sdk"
                }
              ],
              "recursive": true,
              "type": "remove"
            },
            {
              "source": {
                "path": "{{HOMEBREW_PREFIX}}/share/google-cloud-sdk"
              },
              "target": {
                "base": "staged_path",
                "path": "google-cloud-sdk"
              },
              "type": "symlink"
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "preflight_steps"
  },
  {
    "declaration": {
      "uninstall": [
        {
          "trash": "$HOMEBREW_PREFIX/Caskroom/gcloud-cli/latest"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "installer": [
        {
          "script": {
            "args": [
              "--quiet",
              "--usage-reporting",
              "false",
              "--bash-completion",
              "false",
              "--path-update",
              "false",
              "--rc-path",
              "false",
              "--update-installed-components",
              "--install-python",
              "false"
            ],
            "executable": "google-cloud-sdk/install.sh"
          }
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "installer"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/git-credential-gcloud.sh",
        {
          "target": "git-credential-gcloud"
        }
      ],
      "target": "$HOMEBREW_PREFIX/bin/git-credential-gcloud"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/git-credential-gcloud.sh"
    ],
    "target": "$HOMEBREW_PREFIX/bin/git-credential-gcloud",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/gsutil"
      ],
      "target": "$HOMEBREW_PREFIX/bin/gsutil"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/gsutil"
    ],
    "target": "$HOMEBREW_PREFIX/bin/gsutil",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/bq"
      ],
      "target": "$HOMEBREW_PREFIX/bin/bq"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/bq"
    ],
    "target": "$HOMEBREW_PREFIX/bin/bq",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/docker-credential-gcloud"
      ],
      "target": "$HOMEBREW_PREFIX/bin/docker-credential-gcloud"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/docker-credential-gcloud"
    ],
    "target": "$HOMEBREW_PREFIX/bin/docker-credential-gcloud",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "google-cloud-sdk/bin/gcloud"
      ],
      "target": "$HOMEBREW_PREFIX/bin/gcloud"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/bin/gcloud"
    ],
    "target": "$HOMEBREW_PREFIX/bin/gcloud",
    "type": "binary"
  },
  {
    "declaration": {
      "bash_completion": [
        "google-cloud-sdk/completion.bash.inc",
        {
          "target": "google-cloud-sdk"
        }
      ],
      "target": "$HOMEBREW_PREFIX/etc/bash_completion.d/google-cloud-sdk"
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/completion.bash.inc"
    ],
    "target": "$HOMEBREW_PREFIX/etc/bash_completion.d/google-cloud-sdk",
    "type": "bash_completion"
  },
  {
    "declaration": {
      "target": "$HOMEBREW_PREFIX/share/zsh/site-functions/_google_cloud_sdk",
      "zsh_completion": [
        "google-cloud-sdk/completion.zsh.inc",
        {
          "target": "_google_cloud_sdk"
        }
      ]
    },
    "phase": "install",
    "sources": [
      "google-cloud-sdk/completion.zsh.inc"
    ],
    "target": "$HOMEBREW_PREFIX/share/zsh/site-functions/_google_cloud_sdk",
    "type": "zsh_completion"
  },
  {
    "declaration": {
      "postflight_steps": [
        {
          "steps": [
            {
              "force": true,
              "guards": [
                {
                  "condition": "unless_exists",
                  "id": "1",
                  "path": "{{caskroom_path}}/latest"
                }
              ],
              "source": {
                "path": "{{staged_path}}"
              },
              "target": {
                "path": "{{caskroom_path}}/latest"
              },
              "type": "symlink"
            },
            {
              "args": [
                "config",
                "virtualenv",
                "delete",
                "-q"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                },
                {
                  "condition": "if_exists",
                  "id": "3",
                  "path": "~/.config/gcloud/virtenv"
                }
              ],
              "type": "run"
            },
            {
              "args": [
                "config",
                "virtualenv",
                "create",
                "--python-to-use",
                "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                }
              ],
              "network_access": true,
              "type": "run"
            },
            {
              "args": [
                "config",
                "virtualenv",
                "enable"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                }
              ],
              "type": "run"
            },
            {
              "args": [
                "version"
              ],
              "command": {
                "base": "homebrew_prefix",
                "path": "share/google-cloud-sdk/bin/gcloud"
              },
              "env": {
                "CLOUDSDK_PYTHON": "{{HOMEBREW_PREFIX}}/opt/python@3.14/libexec/bin/python"
              },
              "guards": [
                {
                  "condition": "on",
                  "id": "2",
                  "value": "macos"
                }
              ],
              "type": "run"
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "postflight_steps"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "$HOMEBREW_PREFIX/share/google-cloud-sdk.staging",
            "$HOMEBREW_PREFIX/share/google-cloud-sdk"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

Google Cloud CLI 是 Google 的命令行客户端，用于在终端中创建和管理 Google Cloud 项目、资源及应用部署。当前记录的版本为 592.0.0。在 Mac 上，可从 Google 的归档或通过 Homebrew 安装，随后运行 `gcloud init` 选择账号和项目。

### 用途

`gcloud` 涵盖项目配置、身份验证和资源命令。组件包可增加额外的命令组，可用 `gcloud components` 安装或移除。CLI 是 Cloud Console 的终端对应工具，两者使用同一个 Google Cloud 账号。脚本无需浏览器即可调用相同命令。相关客户端见 [Developer Tools 分类](/categories/developer-tools)。

### 在 Mac 上安装

Google 分别为 64 位 Intel（x86_64）和 64 位 ARM64（Apple silicon）发布 macOS 归档。Google 的安装指南也记录了 Homebrew。安装后运行 `gcloud init` 登录并设置项目和默认区域；只需刷新凭据时运行 `gcloud auth login`。用 `gcloud version` 检查构建版本。

用 `gcloud components update` 更新归档安装。Homebrew 安装则遵循该 formula 的升级命令，避免在 PATH 上混用两份副本。

### 系统要求

Google 的安装指南称 CLI 需要 Python 3.10 至 3.15。选择 x86_64 或 ARM64 归档前，用 `uname -m` 确认 Mac 架构。Homebrew cask 同时记录 Apple Silicon 和 Intel。安装指南的包表格未说明 macOS 最低版本、最低内存，也未给出除所列归档大小（x86_64 约 54.8 MB，ARM64 约 54.7 MB）之外的单一磁盘数字。

### 价格与许可

Google 将 CLI 记录为 Google Cloud 账号的客户端。客户端下载在产品页上无需单独支付软件价格。你创建的资源由相应的 Google Cloud 服务计费。身份验证使用对该项目有访问权限的 Google 账号。

### 版本

记录的版本为 592.0.0。Google 发布 CLI 发行说明，介绍组件和命令变更。在 [Azure CLI](/apps/azure-cli) 页面比较 Microsoft 的客户端，在 [Session Manager Plugin](/apps/session-manager-plugin) 页面了解 AWS 会话访问。

### 相关工具

Azure CLI 管理 Azure 订阅。Session Manager Plugin 打开 AWS Systems Manager 会话。使用与你已有云账号匹配的客户端。更多 Mac 终端工具见 [Developer Workbench 合集](/collections/developer-workbench)。

### 常见问题

#### CLI 需要哪些 Python 版本？

Google 的安装指南要求 Python 3.10 至 3.15。

#### 如何选择项目？

运行 `gcloud init` 并选择账号和项目，或稍后用 `gcloud config set project` 设置。

#### 安装 CLI 会产生云费用吗？

安装客户端本身不会创建可计费资源。费用从你在账号上配置 Google Cloud 服务时开始产生。

#### 如何区分 Intel 和 Apple silicon 软件包？

运行 `uname -m`。Google 提供 darwin-x86_64 归档和 darwin-arm 归档。

最后更新：2026-11-05。来源：Google Cloud CLI 安装指南（https://docs.cloud.google.com/sdk/docs/install-sdk），用于 Python 3.10–3.15 和 macOS 归档表格；Homebrew cask 记录，用于版本 592.0.0。

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 594.0.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · 核查于 2026-11-21
  - <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-x86_64.tar.gz>
  - SHA-256: `f8c788cb2ce0af3bd03f236d67c825afe810908f4cd1ade435eb7b5bfb4173c7`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 594.0.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · 核查于 2026-11-21
  - <https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-594.0.0-darwin-arm.tar.gz>
  - SHA-256: `45fbcc5a2caf9ec43847383d2f9fe4720eb8a650349be8d9bd271bdfb6912b55`

## 卸载

- `brew uninstall --cask gcloud-cli`

普通卸载会删除应用本身，设置和缓存会保留。

### 卸载时还会处理

- 文件和文件夹: `$HOMEBREW_PREFIX/Caskroom/gcloud-cli/latest` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

### 深度清理（可选）

- `brew uninstall --zap --cask gcloud-cli`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `$HOMEBREW_PREFIX/share/google-cloud-sdk.staging` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `$HOMEBREW_PREFIX/share/google-cloud-sdk` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 594.0.0 (2026-11-17)

Google Cloud CLI 594.0.0 于 2026-11-17 发布，让位置参数不再被 --account 和 --project 覆盖，并把多组命令提升为正式可用。

**破坏性**

- 认证命令上 \`--account\` 不再覆盖账号参数。
- 账单命令现在要求 ACCOUNT_ID，不再用后面的 \`--account\`。
- shared-vpc 现在要求 PROJECT_ID，不再用后面的 \`--project\`。

**命令行**

- 设置凭据文件覆盖时 config-helper 不再崩溃。
- 失败操作现在会带上错误原因和帮助链接。

**正式版**

- Agent Registry 技能加密和修订下载已正式可用。
- BigLake 取消发布和 Cloud SQL 蓝绿部署已正式可用。
- Cloud Tasks 批量创建和批量删除已正式可用。
- Cloud Run 部署和服务命令的区域端点已正式可用。

**新增**

- AlloyDB 新增 z4d-highmem-16-standardlssd 机器类型。
- Composer 更新可以把 Composer 3 回滚到上一个镜像。
- GKE 创建和更新可以开启集群缩放到零及延迟。

**修复**

- model-garden 部署不再忽略 \`--system-labels\`。
- 存储桶更新现在会合并重复的标签参数。

## 资料与来源

- <https://opennavo.com/zh/apps/gcloud-cli>
- <https://opennavo.com/zh/apps/gcloud-cli/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/g/gcloud-cli.rb> · 核查于 2026-11-21
- <https://formulae.brew.sh/cask/gcloud-cli>
