最稳妥方式是先用tar.getmembers()筛选匹配项并验证路径安全，再传TarInfo对象调用extract()；必须校验member.name不以'/'开头且不含'..'，用os.path.normpath标准化后比对，提取时指定path参数确保目标目录存在。
直接用 TarFile.extract() 或 TarFile.extractall() 提取特定文件最稳妥，但必须注意路径安全性、编码兼容性和成员过滤逻辑——Python 3.10 默认启用更严格的路径检查，硬编码文件名或未清理路径极易触发 tarfile.TarError: Path contains '..'。
如何安全提取单个指定文件（避免路径遍历）
不能直接传入用户输入的文件名给 extract()，因为 TarFile 不自动校验路径合法性。必须先从 getmembers() 中筛选出匹配项，并手动验证其 name 是否为相对路径且不包含 ..。
- 用
tar.getmember(name)获取成员对象（若不存在会抛KeyError），再检查member.name.startswith('/') or '..' in member.name - 推荐改用
tar.getnames()先查全量文件名列表，用os.path.normpath()标准化后比对，例如：os.path.normpath(name) == 'config.json' - 提取时务必传入
member对象而非字符串名，即tar.extract(member, path='output/')，否则可能绕过内部路径检查
如何批量提取多个匹配模式的文件（如所有 .py 文件）
别依赖 extractall(members=...) 直接传入模糊匹配结果——members 参数只接受 TarInfo 列表，且顺序和内容必须严格来自当前 tar 实例，不能是手工构造或过滤后拼接的。
- 正确做法：遍历
tar.getmembers()，用pathlib.PurePosixPath(info.name).suffix == '.py'过滤（统一用 Posix 路径语义，避免 Windows 下反斜杠干扰） - 提取前需确保目标目录存在，
extract()不自动创建父目录；而extractall()的path参数支持指定根目录，但依然不会帮你建中间层 - 若需保留原始目录结构，直接传
members列表给extractall()；若想扁平化到同一目录，得逐个调用extract()并重写member.name
为什么 extract() 在 Python 3.10 报 “Unsupported archive format”？
这不是格式问题，而是你误用了 tarfile.open() 的 mode 参数。Python 3.10 对 mode='r' 的默认行为更严格：它不再自动尝试多种格式探测，遇到非标准头（比如 gzip 压缩但没带 .gz 扩展名）就直接失败。
立即学习“Python免费学习笔记（深入）”；
- 显式指定压缩类型：用
tarfile.open('a.tar.gz', 'r:gz')或'r:bz2'，而不是依赖自动推断 - 若不确定压缩方式，先用
tarfile.is_tarfile()检查是否为 tar 容器，再用shutil.get_unpack_formats()查看系统支持的解压后缀 - 注意：Windows 上某些第三方打包工具生成的 tar 可能使用非 POSIX 时间戳或扩展 header，导致
getmembers()返回空列表——此时需加参数errorlevel=1并捕获TarError
真正麻烦的是嵌套在子目录里的目标文件：比如你想提 app/src/main.py，但 tar 包里实际存的是 project-v1.2/app/src/main.py。这种场景下，光靠文件名匹配不够，得结合 TarInfo.type 判断是否为常规文件（tarfile.REGTYPE），还要处理硬链接与符号链接的重复提取风险。
