Firebase Storage使用gsutil重命名文件夹（路径）解决方案

问题根源 #

谷歌云存储（GCS）是对象存储服务，没有文件系统原生的「文件夹」实体，你看到的目录结构完全是基于对象Key的前缀模拟出来的，所谓的「重命名主文件夹」本质是批量替换所有对应对象的Key前缀。

你之前执行的命令没有效果，核心错误是路径末尾多写了斜杠：

gsutil mv gs://bucket/gamelists/ gs://bucket/games/

带末尾斜杠的路径语义是操作该路径下的所有内容，也就是这条命令实际要做的是「把gamelists文件夹内部的所有文件，移动到games文件夹内部」，根本不是把gamelists文件夹本身重命名为games。如果此时games前缀已经存在存量对象，甚至会出现文件被挪到games/gamelists/下的嵌套问题。

可行操作方案 #

命令行方案（推荐） #

去掉两个路径末尾的斜杠再执行即可达到重命名主文件夹的效果：

# 文件夹内文件数量少可以直接执行
gsutil mv gs://bucket/gamelists gs://bucket/games

# 文件夹下有大量媒体文件、子目录时，加-m参数开启并行处理，迁移速度会快很多
gsutil -m mv gs://bucket/gamelists gs://bucket/games

执行注意事项：

• 运行命令前先确认gs://bucket/games路径下没有已存在的对象，否则会出现路径嵌套
• 同存储桶内的mv操作只修改对象元数据，不会产生外网流出流量，执行速度远快于跨桶迁移
• 命令执行完成后如果控制台还能看到空的gamelists文件夹，直接删除即可：这是控制台生成的虚拟占位符，没有对应实际存储的对象，删除不会影响任何已迁移的文件

控制台可视化方案 #

如果不想敲命令，可以直接在GCS网页控制台找到gamelists文件夹，点击右侧操作菜单里的「重命名」，输入games确认即可。这个操作后台跑的逻辑和上面的gsutil命令完全一致，都是批量修改对象Key前缀，不存在什么“直接修改文件夹名”的特殊原子接口。

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