从云存储上传TensorBoard日志到Vertex AI时tb-gcp-uploader命令未识别

这个报错的核心原因是tb-gcp-uploader工具未安装，或是安装后可执行文件路径未加入系统环境变量，可按以下步骤排查处理：

1. 安装对应依赖包 #

tb-gcp-uploader属于Google Cloud AI平台SDK的TensorBoard附加组件，直接通过pip安装即可：

• 标准安装命令：pip install google-cloud-aiplatform[tensorboard]
• 如果安装时报权限错误，Linux/macOS可在命令末尾加--user参数，Windows可用管理员身份启动终端再执行安装
• 安装完成后可先执行tb-gcp-uploader --version验证，能正常输出版本号即为安装成功

2. 修复环境变量配置 #

如果安装完成后仍然提示找不到命令，就是Python的可执行文件目录未加入系统PATH：

Windows系统 #

• 先找到pip安装脚本的目录，通常路径为C:\Users\你的用户名\AppData\Roaming\Python\PythonXX\Scripts（XX对应你的Python版本号，如39对应Python3.9）
• 将该路径添加到系统环境变量的PATH中，重启终端后即可正常调用

macOS/Linux系统 #

• 执行pip show google-cloud-aiplatform找到Location字段，例如输出为/usr/local/lib/python3.10/site-packages，则可执行文件一般在/usr/local/bin或~/.local/bin目录下
• 将对应bin目录路径添加到shell配置文件中：使用zsh则加export PATH=$PATH:~/.local/bin到~/.zshrc，使用bash则加至~/.bashrc，执行source 对应配置文件路径生效后，重启终端即可

3. 临时调用方案 #

如果不想修改环境变量，也可以直接通过Python模块调用该工具，只需将原命令开头的tb-gcp-uploader替换为python -m google.cloud.aiplatform.tensorboard.uploader即可，其余参数保持不变。

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