腳本之家服務器常用軟件

快捷導航

Python的tarfile模塊解壓縮.tar/.tar.gz等文件詳解

更新時間：2026年04月02日 11:01:06 作者：科雷learning

本文介紹了Python標準庫tarfile的使用方法,包括tarfile.open、TarFile.add、TarFile.extractall、TarFile.getmembers等核心函數(shù)和參數(shù)的使用,以及注意事項,特別強調了在Windows環(huán)境下處理中文文件名亂碼的問題,感興趣的朋友跟隨小編一起看看吧

Python的tarfile模塊解壓縮.tar/.tar.gz等文件

python中的標準庫tarfile模塊可以幫助我們快速壓縮或者解壓后綴為
.tar/.tar.gz/.tar.bz2/.tar.xz的文件。

01 tarfile核心類與函數(shù)介紹

因為tarfile是標準庫，我們直接import tarfile即可使用。

tarfile模塊的核心是TarFile類，通過它可以完成創(chuàng)建、讀取、修改 tar 文件的操作。但在實際使用中我們經(jīng)常使用tarfile.open函數(shù)，open函數(shù)其實調用的是tarfile.TarFile.open類函數(shù)，源代碼如下：

open類函數(shù)比TarFile類本身支持更多的mode。

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

功能：打開或創(chuàng)建一個tar文件，返回TarFile對象。

參數(shù)：

name：tar文件名（如'archive.tar'）。
mode：打開模式，常見取值：'r'：以只讀模式打開已存在的tar文件。'w'：創(chuàng)建新的tar文件并覆蓋原有內容。'a'：以追加模式打開tar文件。結合壓縮格式：'w:gz'：表示使用gzip壓縮），'w:bz2'：表示使用bzip2壓縮 ,'w:xz'：表示使用lzma壓縮。
fileobj：文件對象（可選），若指定則使用該對象進行操作。

案例：創(chuàng)建不同格式的壓縮文件,不同的壓縮算法壓縮后的文件大小是不同的。

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文件中。

參數(shù)解析：

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+增加的參數(shù)，以前的版本是exclude參數(shù)）

：filter函數(shù)接收一個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: 動態(tài)修改歸檔路徑

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參數(shù) vs exclude參數(shù)說明：

特性	filter (Python 3.8+)	exclude (舊版)
參數(shù)類型	處理TarInfo的函數(shù)	判斷路徑的函數(shù)
功能	修改或排除文件	僅排除文件
靈活性	高（可修改元數(shù)據(jù)）	低（僅路徑判斷）
兼容性	Python 3.8+	所有版本

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

功能：解壓tar文件中的所有內容到指定路徑。

參數(shù)：

path：解壓目標路徑（默認當前目錄）。
members：指定解壓的成員列表（默認解壓全部）。
numeric_owner：是否使用數(shù)字用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對象包含了文件的詳細元數(shù)據(jù)，如文件名、大小、修改時間等。

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}字節(jié)")
	print(f"修改時間:?{info.mtime}, 權限:?{info.mode}")

或者使用TarFile.gettarinfo函數(shù)獲取單個文件的TarInfo對象，此處不在贅述。

5. TarFile.getnames()

功能：返回tar文件中所有成員的名稱列表。

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

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

功能：解壓指定的單個文件或目錄。參數(shù)member填文件名或者帶路徑的文件名，如果找不到路徑會報錯。path默認解壓到當前目錄。

with?tarfile.open('project2.tar.gz',?'r')?as?tar:
? ? tar.extract('dir1/Python從入門到精通.pdf',path='1/2')?#將單個文件解壓到某一個目錄

7.內存中操作 tar 文件

使用io.BytesIO可以在內存中創(chuàng)建和操作 tar 文件，無需寫入磁盤。

import?tarfile
import?io
buffer = io.BytesIO()
#使用fileobj參數(shù)
with?tarfile.open(fileobj=buffer, mode='w')?as?tar:
? ? tar.add('data.txt')
? ? # 獲取內存中的tar數(shù)據(jù)
? ? tar_data = buffer.getvalue().decode()
? ? print(tar_data)

02 函數(shù)總結

功能場景	核心函數(shù) / 方法	關鍵參數(shù) / 注意事項
創(chuàng)建 tar 文件	TarFile.open('name.tar', 'w')	選擇合適的壓縮模式（如'w:gz'）
添加文件 / 目錄	TarFile.add()	arcname可重命名歸檔路徑
解壓文件	TarFile.extract() / extractall()	指定正確的目標路徑
遍歷文件列表	TarFile.getmembers() / getnames()	用于檢查歸檔內容
追加文件	TarFile.open('name.tar', 'a')	避免文件名沖突