通过Cloud SDK安装的gsutil如何升级至5.x版本

你当前遇到的gcloud components update无法升级gsutil大版本的问题，是因为旧版本Cloud SDK的组件源仅提供适配当前SDK版本的gsutil包，默认不会跨大版本推送更新。

方案1：通过Cloud SDK官方渠道升级（推荐） #

该方案可保证gsutil和Cloud SDK其余组件的兼容性，操作步骤如下：

• 先卸载当前设备上的旧版本Cloud SDK：
  • 若通过apt等系统包管理器安装，执行对应卸载命令，例如Debian/Ubuntu环境下运行sudo apt remove google-cloud-sdk
  • 若为手动解压安装，直接删除Cloud SDK的安装目录即可
• 安装最新版本的Cloud SDK
• 安装完成后执行gcloud components update，此时会自动拉取适配最新SDK的gsutil 5.x版本
• 验证升级结果：运行gsutil --version确认版本号为5.x即可

方案2：通过pip3单独安装gsutil 5.x #

如果你不需要升级整个Cloud SDK，可以选择单独安装独立版本的gsutil，操作步骤如下：

• 执行升级命令：pip3 install --upgrade gsutil
• 验证路径优先级：运行which gsutil，确认返回路径是pip对应包目录下的gsutil（通常为~/.local/bin/gsutil），而非Cloud SDK安装目录下的bin路径
• 若路径仍指向Cloud SDK自带的旧版本，将pip的bin目录加入环境变量PATH的最前列：
  1. 编辑终端配置文件（_/.bashrc、/.zshrc等），添加一行export PATH="$HOME/.local/bin:$PATH"
  2. 执行source ~/.bashrc（或对应你使用的配置文件）使配置生效
• 验证升级结果：运行gsutil --version确认版本号为5.x即可

注意：使用pip安装独立版gsutil后，该版本将脱离Cloud SDK的组件管理，后续更新需要自行执行pip3 install --upgrade gsutil操作。如果需要切回Cloud SDK管理的gsutil版本，执行pip3 uninstall gsutil并恢复PATH优先级即可。

内容的提问来源于stack exchange，提问作者Keet Sugathadasa