Python的tarfile模块解压缩.tar/.tar.gz等文件详解

 更新时间:2026年04月02日 11:01:06   作者:科雷learning  
本文介绍了Python标准库tarfile的使用方法,包括tarfile.open、TarFile.add、TarFile.extractall、TarFile.getmembers等核心函数和参数的使用,以及注意事项,特别强调了在Windows环境下处理中文文件名乱码的问题,感兴趣的朋友跟随小编一起看看吧

Python的tarfile模块解压缩.tar/.tar.gz等文件

python中的标准库tarfile模块可以帮助我们快速压缩或者解压后缀为
.tar/.tar.gz/.tar.bz2/.tar.xz的文件。

01 tarfile核心类与函数介绍

因为tarfile是标准库,我们直接import tarfile即可使用。

tarfile模块的核心是TarFile类,通过它可以完成创建、读取、修改 tar 文件的操作。但在实际使用中我们经常使用tarfile.open函数,open函数其实调用的是tarfile.TarFile.open类函数,源代码如下:

open类函数比TarFile类本身支持更多的mode。

1. tarfile.open(name, mode='r', fileobj=None, **kwargs)

功能:打开或创建一个tar文件,返回TarFile对象。

参数

  • name:tar文件名(如'archive.tar')。
  • mode:打开模式,常见取值:'r':以只读模式打开已存在的tar文件。'w':创建新的tar文件并覆盖原有内容。'a':以追加模式打开tar文件。结合压缩格式:'w:gz':表示使用gzip压缩),'w:bz2':表示使用bzip2压缩 ,'w:xz':表示使用lzma压缩。
  • fileobj:文件对象(可选),若指定则使用该对象进行操作。

案例:创建不同格式的压缩文件,不同的压缩算法压缩后的文件大小是不同的。

import tarfile
with tarfile.open('example.tar', 'r') as tar:
    pass
with tarfile.open('example.tar.gz', 'w:gz') as tar:
    pass
with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
    pass
with tarfile.open('example.tar.xz', 'w:xz') as tar:
    pass
#追加文件到已有的压缩文件
with tarfile.open('existing.tar', 'a') as tar:
    tar.add('new_file.txt')

2. TarFile.add(name, arcname=None, recursive=True, filter=None)

功能:将文件或目录添加到tar文件中。

参数解析:

name:指定要归档的文件或目录路径。

with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
  tar.add('/home/user/data.csv')  # 绝对路径
  tar.add('docs/README.md')       # 相对路径

arcname:设置文件在tar包中的归档名称(默认为原路径)。

with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
    # 将本地文件归档为archive.tar中的data/input.csv
    tar.add('input.csv', arcname='data/input.csv')

recursive:是否递归归档目录内容(仅对目录有效),默认递归处理所有子目录。

with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
    # 仅归档src目录本身,不包含其内容
    tar.add('src', recursive=False)

filter(Python 3.8+增加的参数,以前的版本是exclude参数)

:filter函数接收一个TarInfo对象,返回修改后的对象或None(排除该文件);使用时会对每个TarInfo对象进行转换或过滤。

案例1: 修改文件属性

def set_permissions(tarinfo):
    tarinfo.mode = 0o644# 设置文件权限
    return tarinfo
with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
    tar.add('scripts', filter=set_permissions)

案例2 :基于条件过滤文件

def exclude_large_files(tarinfo):
    if tarinfo.size > 1024 * 1024:  # 大于1MB的文件
        print(f"排除大文件: {tarinfo.name}")
        return None
    return tarinfo
with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
    tar.add('logs/', filter=exclude_large_files)

案例3: 动态修改归档路径

def remap_path(tarinfo):
    tarinfo.name = tarinfo.name.replace('src/', 'source/')
    return tarinfo
with tarfile.open('example.tar.bz2', 'w:bz2') as tar:
    tar.add('src/', filter=remap_path)

filter参数 vs exclude参数说明:

特性

filter (Python 3.8+)

exclude (旧版)

参数类型

处理TarInfo的函数

判断路径的函数

功能

修改或排除文件

仅排除文件

灵活性

高(可修改元数据)

低(仅路径判断)

兼容性

Python 3.8+

所有版本

3. TarFile.extractall(path='.', members=None, *, numeric_owner=False)

功能:解压tar文件中的所有内容到指定路径。

参数

  • path:解压目标路径(默认当前目录)。
  • members:指定解压的成员列表(默认解压全部)。
  • numeric_owner:是否使用数字用ID和组ID(默认False)。

案例:解压tar.gz全部的文件

import tarfile
with tarfile.open('project.tar.gz', 'r:gz') as tar:
    tar.extractall('extracted_project')

4. TarFile.getmembers()

功能:返回tar文件中所有成员的TarInfo对象列表,TarInfo对象包含了文件的详细元数据,如文件名、大小、修改时间等 。

import tarfile
with tarfile.open('project.tar', 'r') as tar:
    members_info = tar.getmembers()
    for info in members_info:
        print(f"文件名: {info.name}, 大小: {info.size}字节")
	print(f"修改时间: {info.mtime}, 权限: {info.mode}")

或者使用TarFile.gettarinfo函数获取单个文件的TarInfo对象,此处不在赘述。

5. TarFile.getnames()

功能:返回tar文件中所有成员的名称列表。

import tarfile
with tarfile.open('project2.tar.gz', 'r') as tar:
    print(tar.getnames())

6. TarFile.extract(member, path='.')

功能:解压指定的单个文件或目录。参数member填文件名或者带路径的文件名,如果找不到路径会报错。path默认解压到当前目录。

with tarfile.open('project2.tar.gz', 'r') as tar:
    tar.extract('dir1/Python从入门到精通.pdf',path='1/2') #将单个文件解压到某一个目录

7.内存中操作 tar 文件

使用io.BytesIO可以在内存中创建和操作 tar 文件,无需写入磁盘。

import tarfile
import io
buffer = io.BytesIO()
#使用fileobj参数
with tarfile.open(fileobj=buffer, mode='w') as tar:
    tar.add('data.txt')
    # 获取内存中的tar数据
    tar_data = buffer.getvalue().decode()
    print(tar_data)

02 函数总结

功能场景

核心函数 / 方法

关键参数 / 注意事项

创建 tar 文件

TarFile.open('name.tar', 'w')

选择合适的压缩模式(如'w:gz')

添加文件 / 目录

TarFile.add()

arcname可重命名归档路径

解压文件

TarFile.extract() / extractall()

指定正确的目标路径

遍历文件列表

TarFile.getmembers() / getnames()

用于检查归档内容

追加文件

TarFile.open('name.tar', 'a')

避免文件名冲突

03 注意事项

在windows环境下,执行压缩后,如果在电脑上直接打开,会发现中文显示乱码。

此时可以通过tarfile的解压函数extractall解压,然后再查看中文显示正常。

到此这篇关于Python的tarfile模块解压缩.tar/.tar.gz等文件详解的文章就介绍到这了,更多相关Python tarfile模块解压缩内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python super()方法原理详解

    Python super()方法原理详解

    这篇文章主要介绍了Python super()方法原理详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-03-03
  • 不同系统下python与pip的安装及常见问题详解

    不同系统下python与pip的安装及常见问题详解

    学习python的第一步,是安装python,这篇文章主要是介绍,如何在不同的系统上安装python,以及遇到的一些问题,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-01-01
  • Python基础-特殊方法整理详解

    Python基础-特殊方法整理详解

    python中特殊方法(魔术方法)是被python解释器调用的,我们自己不需要调用它们,我们统一使用内置函数来使用。本篇文章将对其详细介绍,感兴趣的小伙伴可以参考下面文章的具体内容
    2021-09-09
  • python安装win32com.client的实现示例

    python安装win32com.client的实现示例

    win32com.client是Python操作Windows COM对象的模块,用于与Office交互,本文主要介绍了python安装win32com.client的实现示例,具有一定的参考价值,感兴趣的可以了解一下
    2025-06-06
  • Python实现简单猜数字游戏

    Python实现简单猜数字游戏

    这篇文章主要为大家详细介绍了Python实现猜数字游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-02-02
  • Pytorch中torch.unsqueeze()与torch.squeeze()函数详细解析

    Pytorch中torch.unsqueeze()与torch.squeeze()函数详细解析

    torch.squeeze()这个函数主要对数据的维度进行压缩,去掉维数为1的的维度,下面这篇文章主要给大家介绍了关于Pytorch中torch.unsqueeze()与torch.squeeze()函数详细的相关资料,需要的朋友可以参考下
    2023-02-02
  • 使用Python自动化创建和扫描二维码

    使用Python自动化创建和扫描二维码

    二维码(Quick Response code)已成为在物理和数字领域之间架起桥梁的多功能工具,从分享联系信息和网站链接到促进支付和跟踪库存,二维码在各个行业中找到了应用,本文将展示如何使用Python自动化创建和扫描二维码,感兴趣的朋友可以参考下
    2024-07-07
  • Python numpy ndarray属性,索引,切片

    Python numpy ndarray属性,索引,切片

    这篇文章主要介绍了Python numpy ndarray属性,索引,切片,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-09-09
  • django中间键重定向实例方法

    django中间键重定向实例方法

    在本篇文章里小编给各位分享的是关于django中间键重定向实例方法以及相关代码,需要的朋友们学习下吧。
    2019-11-11
  • 一文完全掌握Python三大语句之顺序、条件与循环

    一文完全掌握Python三大语句之顺序、条件与循环

    Python是一种简单而强大的编程语言,它提供了多种结构和语句,使得程序编写变得更加灵活和高效,这篇文章主要介绍了Python三大语句之顺序、条件与循环的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-08-08

最新评论