python 操作 minio 需先安装官方 sdk。1. 安装 minio 库并初始化客户端连接，需提供服务地址、access key、secret key 及 https 设置；2. 创建 bucket 前应检查其是否存在；3. 使用 upload_file 方法上传文件，注意路径正确性与大文件分片处理；4. 用 fget_object 下载文件，remove_object 删除文件；5. list_objects 可列出指定目录文件；6. presigned_get_object 生成带过期时间的临时下载链接。以上步骤覆盖了常见文件操作，适用于大多数业务场景。
MinIO 是一个高性能、兼容 S3 协议的对象存储系统，非常适合用来做私有云或本地部署的文件存储。如果你用 Python 做后端开发或者数据处理，很多时候会需要上传、下载、管理这些对象文件。那 Python 怎么操作 MinIO 呢？其实挺简单的，只要用官方提供的 SDK 就行。
安装和初始化连接
第一步是安装 MinIO 的 Python 客户端库：
pip install minio
然后你需要准备几个参数：MinIO 服务地址、访问密钥（Access Key）、秘密密钥（Secret Key），以及是否使用 HTTPS。接着就可以初始化客户端了：
立即学习“Python免费学习笔记（深入）”；
from minio import Minio
client = Minio(
"play.min.io", # 替换为你自己的地址
access_key="YOUR_ACCESS_KEY",
secret_key="YOUR_SECRET_KEY",
secure=True # 是否启用 HTTPS
)这一步如果报错，多半是网络不通或者密钥不对，检查一下防火墙设置和密钥信息就行。
创建 Bucket 并上传文件
MinIO 里的 bucket 相当于一个文件夹容器。你可以先判断 bucket 是否存在，不存在就创建它：
bucket_name = "my-photos"
if not client.bucket_exists(bucket_name):
client.make_bucket(bucket_name)上传文件也很直接，使用 upload_object 方法即可：
client.upload_file(
bucket_name,
"2024/photo.jpg", # 对象名称，可以带路径
"local_photo.jpg" # 本地文件路径
)注意两点：
- 文件路径要写对，否则会提示找不到；
- 如果你上传的是大文件，建议分片上传（用
fput_object或者流式上传）。
下载和删除文件
下载文件可以用 fget_object 方法，把远程文件保存到本地：
client.fget_object(
bucket_name,
"2024/photo.jpg", # 远程路径
"downloaded_photo.jpg" # 本地保存路径
)删除的话就更简单了：
client.remove_object(bucket_name, "2024/photo.jpg")
如果你要批量删除，可以循环调用这个方法，或者用 list_objects 列出一批再删。
列出文件和生成临时链接
有时候你想看看某个目录下有哪些文件，可以用 list_objects：
objects = client.list_objects(bucket_name, prefix="2024/", recursive=False)
for obj in objects:
print(obj.object_name)prefix 参数相当于限定目录，recursive 控制是否递归查找子目录。
另外，如果你希望生成一个临时可访问的 URL（比如给前端下载用），可以用：
url = client.presigned_get_object(
bucket_name,
"2024/photo.jpg",
expires=timedelta(hours=1) # 链接有效期
)这个 URL 默认是 GET 请求可用，也可以生成 PUT 的链接用于上传。
基本上就这些。Python 操作 MinIO 其实不复杂，但要注意权限控制和网络问题。有些功能比如分片上传、事件通知等稍微复杂点，但在大多数业务场景下，上面这些操作已经够用了。
