如何使用Python在Google Cloud Storage中创建含指定文件夹的新存储桶

嘿，我来帮你搞定这个问题！首先得明确一个核心点：Google Cloud Storage（GCS）本身不存在真正的文件夹结构——你在UI里看到的“文件夹”，本质都是通过对象前缀模拟出来的。要创建“空文件夹”，其实就是创建一个名称以/结尾的空对象，GCS会自动把它识别为文件夹展示。

下面是完整的Python代码示例，包含创建存储桶和两个目标文件夹的操作：

from google.cloud import storage

def create_bucket_and_folders(bucket_name, project_id, location="us-central1"):
    # 初始化GCS客户端
    client = storage.Client(project=project_id)
    
    # 创建存储桶（注意：桶名必须全局唯一）
    bucket = client.create_bucket(bucket_name, location=location)
    print(f"存储桶 {bucket.name} 创建成功")
    
    # 定义要创建的文件夹名称（必须以/结尾）
    folders = ["processed/", "unprocessed/"]
    
    for folder_name in folders:
        # 创建对应路径的Blob对象
        blob = bucket.blob(folder_name)
        # 上传空字符串来生成这个"文件夹"对象
        blob.upload_from_string("")
        print(f"模拟文件夹 {folder_name} 创建成功")

# 调用示例（替换为你的项目ID和全局唯一的桶名）
create_bucket_and_folders(
    bucket_name="your-unique-bucket-name-123",
    project_id="your-google-cloud-project-id"
)

补充细节： #

• 桶名唯一性：GCS的桶名是全局唯一的，所以你得确保your-unique-bucket-name-123没被其他用户占用。
• 避免重复创建报错：如果脚本可能重复运行，建议先判断资源是否存在：
  • 检查桶是否存在：client.bucket(bucket_name).exists()
  • 检查文件夹是否存在：bucket.blob(folder_name).exists()
• 区域可选：示例用了us-central1作为存储区域，你可以换成GCS支持的其他区域（比如europe-west1、asia-southeast1等）。

这样操作后，你就能在GCS控制台里看到processed和unprocessed两个空文件夹啦！

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