Python使用wget库下载维基百科图片报IndexError异常如何修复

• 报错的来源是第三方Python版wget库（和系统CMD中可直接调用的GNU wget工具不是同一个程序）的固有代码缺陷，和你传入的自定义输出路径参数无直接关系。
• 从报错栈可定位触发位置为库内filename_from_headers方法的边界判断缺失：该方法用于从HTTP响应的Content-Disposition头中提取文件名，代码默认拆分后得到的字段列表非空，可直接取第一个元素拆分文件名参数。
• 维基百科图片CDN返回的响应头格式与库的预期不匹配，导致拆分后的字段列表为空，调用fnames[0]时直接触发索引越界。
• 手动指定输出文件名仍报错的原因：该库的下载流程逻辑设计为，无论用户是否传入明确的输出路径，都会强制先执行一遍响应头的文件名解析流程，这个解析步骤的崩溃会直接中断后续下载，无法通过传参跳过。

临时补丁（无需更换依赖，改动最小） #

• 无需修改全局安装的库文件，只需在你的下载代码最开头添加异常捕获补丁，替换原有的解析函数：

import wget

# 保留原解析函数的逻辑，仅捕获索引越界的异常
_original_parse = wget.filename_from_headers
def _safe_parse(headers):
    try:
        return _original_parse(headers)
    except IndexError:
        # 解析失败时返回空字符串，走库内置的后续文件名识别逻辑
        return ''

wget.filename_from_headers = _safe_parse

# 原有下载逻辑可正常执行
url = "https://upload.wikimedia.org/wikipedia/commons/thumb/b/b6/Image_created_with_a_mobile_phone.png/1200px-Image_created_with_a_mobile_phone.png"
save_dir = r"C:/Users/Family/Pictures/downloads"
wget.download(url, save_dir)

长期稳妥替代方案 #

• 第三方Python版wget库已长期停止维护，兼容场景覆盖有限，对于简单文件下载场景，可直接使用Python标准库的urllib.request实现，无额外依赖、兼容度更高：

import urllib.request

url = "https://upload.wikimedia.org/wikipedia/commons/thumb/b/b6/Image_created_with_a_mobile_phone.png/1200px-Image_created_with_a_mobile_phone.png"
save_path = r"C:/Users/Family/Pictures/downloads/1200px-Image_created_with_a_mobile_phone.png"
# 直接发起请求并写入文件
urllib.request.urlretrieve(url, save_path)

• 该方式的行为逻辑和系统CMD中的GNU wget一致，只要传入明确的保存路径，就不会强制解析响应头的文件名，可完全规避这类格式不匹配导致的崩溃。

• 不要混淆Python第三方wget库和系统命令行的wget工具：前者是轻量纯Python实现的下载脚本，没有做各类异常场景的兼容；后者是经过长期迭代的成熟下载工具，对非标准响应头的容错性极强，因此同个链接在CMD可正常下载、Python库报错是正常现象。
• 可通过抓包查看维基百科图片接口返回的Content-Disposition字段值，即可确认是头格式不匹配触发的解析异常。

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