Python requests下载图片文件：流式保存与文件命名

用requests以流式方式下载网络图片到本地，处理大文件边下边存不占内存，自动识别扩展名，适合批量保存素材、图标、照片。

场景痛点

设计稿里有几十张配图、产品库有几百张主图，手动一张张右键"图片另存为"，鼠标点到冒烟。用requests把图片URL列表丢进脚本，自动下载、自动命名，几秒钟搞定，而且不用打开浏览器。

用到的库

pip install requests beautifulsoup4 lxml

完整代码

# 导入库
import os
import requests

def download_image(url, save_dir="images", filename=None):
"""下载单张图片到本地"""
# 建文件夹，存在就不报错
os.makedirs(save_dir, exist_ok=True)

# 没指定文件名就从URL里取最后一段
if filename is None:
filename = url.rstrip("/").split("/")[-1]
# 去掉URL里可能带的查询参数
filename = filename.split("?")[0]

save_path = os.path.join(save_dir, filename)

# stream=True 表示流式下载，不会一次性把整个文件读进内存
with requests.get(url, stream=True, timeout=30) as resp:
resp.raise_for_status()  # 不是200就抛异常

# 边读边写，每次读8KB
with open(save_path, "wb") as f:
for chunk in resp.iter_content(chunk_size=8192):
# 过滤掉keep-alive的空块
if chunk:
f.write(chunk)

print(f"已下载：{save_path}（{os.path.getsize(save_path)//1024} KB）")
return save_path

def main():
# 示例图片URL（用占位图服务做演示）
urls = [
"https://httpbin.org/image/png",
"https://httpbin.org/image/jpeg",
]

for i, url in enumerate(urls, 1):
try:
# 给文件起个有意义的名字
ext = url.split("/")[-1]
download_image(url, save_dir="images", filename=f"demo_{i}.{ext}")
except Exception as e:
print(f"下载失败 {url}：{e}")

if __name__ == "__main__":
main()

代码讲解

关键是 stream=True，加了这个参数后requests不会立刻把整个响应读进内存，而是建立了一个数据流，配合 iter_content 一块一块地读。下载几百MB的视频也不会把内存占满。
with open(save_path, "wb") 以二进制写模式打开文件，图片是二进制数据，必须用 wb，不能用默认的文本模式。
chunk_size=8192 表示每次读8KB，可以根据需要调整，文件大就调大些。
resp.raise_for_status() 会在状态码不是200时直接抛异常，避免把404页面的HTML当成图片存下来。
os.makedirs(..., exist_ok=True) 自动建目录，重复运行不会报错。