Python tarfile.TarInfo.replace 怎样复制归档成员属性
TarInfo.replace() 返回一个新的归档成员属性对象,并替换指定的 name、mtime、mode 等字段;原对象的对应字段不变。默认使用深复制。它复制的是元数据,不会读取文件内容,也不会自动修改已经存在的 tar 文件。
官方文档:https://docs.python.org/3.14/library/tarfile.html#tarfile.TarInfo.replace
先区分成员元数据与文件内容
TarInfo 描述归档成员的名称、大小、权限、时间与所有者等信息。要给同一份内容生成另一套属性,直接改原对象会让后续代码也看到修改。replace 将“保留原属性”和“生成新属性”明确分开,更适合一个成员需要多种输出表示的场景。
例如一份说明文件原来叫 notes/source.txt,归档输出希望叫 docs/readme.txt,并使用统一时间和权限。这里需要改变的是成员元数据;文件内容仍是另一份输入。方法自 Python 3.12 提供,本文以 Python 3.14 接口为依据。
用 replace 选择性修改属性
import tarfile
# 构造成员属性,不读取或修改磁盘文件
original = tarfile.TarInfo("notes/source.txt")
original.size = 4
original.mtime = 1700000000
original.mode = 0o600
# 返回新对象,未指定的 size 等属性保留
updated = original.replace(
name="docs/readme.txt",
mtime=0,
mode=0o644,
)
print(original.name, oct(original.mode), original.mtime)
print(updated.name, oct(updated.mode), updated.mtime)
print(original is updated, updated.size)示例预期原对象仍是 notes/source.txt、权限 0o600、原来的时间戳;新对象是 docs/readme.txt、权限 0o644、时间戳 0。两个对象不是同一个对象,新对象仍保留 size 为 4。本文未运行代码,这些值供读者本地复现时比对。
支持选择性替换的公开参数包括 name、mtime、mode、linkname、uid、gid、uname、gname,均按关键字传入。不要把 size 当作 replace 的参数;需要调整内容大小时,应在新的 TarInfo 对象上设置与实际字节内容相符的 size。未指定字段与显式传入零不是一回事:mtime=0 正是一次有效替换。

图中“原 TarInfo”“原名称”“原大小”属于输入,“新 TarInfo”“新名称”“保留大小”属于副本。连线不表示归档文件已被改写。
深复制与浅复制怎样选择
import tarfile
original = tarfile.TarInfo("notes.txt")
original.pax_headers = {"comment": "source"}
# 默认深复制:新字典与原字典独立
independent = original.replace(name="independent.txt")
independent.pax_headers["comment"] = "independent"
print(original.pax_headers["comment"])
# 浅复制仍是新的 TarInfo,但内部字典共享
shared = original.replace(name="shared.txt", deep=False)
shared.pax_headers["comment"] = "shared"
print(original.pax_headers["comment"])
print(shared is original, shared.pax_headers is original.pax_headers)第一次修改独立副本的 pax_headers,预期原字典中的 comment 仍为 source。第二次修改浅副本的同一个字典,预期原对象读取到 shared。最后一行预期分别为 False、True:TarInfo 是新对象,但 pax_headers 指向同一个字典。
所以 shallow 的关键是内部引用共享,不能简单理解为“所有修改都会同步”。对浅副本重新赋值 name 不会给原对象重新赋值;对共享字典进行原地修改才会影响另一方。默认深复制适合需要独立编辑元数据的情况,deep=False 适合已经明确接受共享关系的调用方。

图中的“原对象”“原字典”“深副本”“独立字典”“浅副本”“共享引用”解释引用结构:深副本关联独立字典,浅副本的共享引用关联原字典。
把修改后的属性交给归档写入
只有把新对象交给写入接口,才会创建使用新属性的归档成员。下面全部在内存里操作,内容长度由实际 payload 计算,不覆盖任何已有文件。
import io
import tarfile
payload = b"memo\n"
original = tarfile.TarInfo("notes/source.txt")
original.size = len(payload)
original.mode = 0o600
# 新属性对象和内容流分别提供给写入接口
updated = original.replace(name="docs/readme.txt", mode=0o644, mtime=0)
archive_buffer = io.BytesIO()
with tarfile.open(fileobj=archive_buffer, mode="w") as archive:
with io.BytesIO(payload) as content:
archive.addfile(updated, content)
# 仅在内存读取成员属性,不解压到磁盘
archive_buffer.seek(0)
with tarfile.open(fileobj=archive_buffer, mode="r:") as archive:
member = archive.getmember("docs/readme.txt")
print(member.name, member.size, oct(member.mode), member.mtime)预期读取到 docs/readme.txt、大小 5、权限 0o644、时间戳 0。addfile 需要的成员描述与内容流分别提供,replace 不承担内容复制。with 负责关闭 TarFile 和内容流;归档缓冲区在重新读取前回到开头。
对于已有对象的 pax_headers,如果它包含 path、mtime 等与目标字段对应的扩展项,还应明确处理这些扩展值的一致性。replace 是复制后赋值,不会替调用方自动清理所有可能覆盖字段的 PAX 扩展。本文示例从全新对象开始,避免把已有扩展元数据混入属性演示。
实现参考:https://github.com/python/cpython/blob/3.14/Lib/tarfile.py
兼容性与常见问题
| 需求 | 对应做法 |
|---|---|
| 替换名称、权限或时间 | 使用 replace 的对应关键字 |
| 副本字典独立编辑 | 保留默认 deep=True |
| 接受内部对象共享 | 明确选择 deep=False |
| 生成新归档成员 | 向 addfile 提供新元数据和内容流 |
replace 会改变原 tar 文件吗?
不会。它只返回新的 Python 元数据对象,持久化需要另行写入归档。
deep=False 是否返回原对象?
不是。返回的仍是副本,只是 pax_headers 等内部对象可以共享。
Python 3.11 可以直接使用吗?
这个方法自 3.12 提供。维护旧版本代码时应明确最低版本,或另行使用复制后赋值的兼容实现,不把两种接口混写。
Python multiprocessing forkserver 怎样处理进程启动上下文
- 上一篇
- Python multiprocessing forkserver 怎样处理进程启动上下文
- 下一篇
- Python annotationlib.get_annotate_from_class_namespace 怎样取得注解函数
-
- 文章 · python教程 | 15分钟前 | 线程池 · Python 线程池 concurrent.futures 任务取消 Future.cancel
- Python concurrent.futures.Future.cancel 怎样判断任务能否取消
- 143浏览 收藏
-
- 文章 · python教程 | 21分钟前 | 标准库 · HTTP服务 · 多线程 · Python教程 · Python 并发请求 http.server ThreadingHTTPServer ThreadingMixIn BaseHTTPRequestHandler
- Python http.server ThreadingHTTPServer 怎样处理并发请求
- 481浏览 收藏
-
- 文章 · python教程 | 27分钟前 | 并发编程 · Python教程 · Python 多进程 multiprocessing forkserver 启动上下文
- Python multiprocessing forkserver 怎样处理进程启动上下文
- 232浏览 收藏
-
- 文章 · python教程 | 28分钟前 | 标准库 · 异步编程 · Python教程 · Python asyncio StreamReader readexactly IncompleteReadError 异步流
- Python asyncio.StreamReader.readexactly 怎样处理不足长度的输入
- 427浏览 收藏
-
- 文章 · python教程 | 31分钟前 |
- Python operator.length_hint 怎样为未知长度迭代器设置估计值
- 336浏览 收藏
-
- 文章 · python教程 | 48分钟前 | 标准库 · Python教程 · Python warnings catch_warnings simplefilter filterwarnings 警告过滤
- Python warnings context manager 怎样临时调整警告过滤
- 255浏览 收藏
-
- 文章 · python教程 | 49分钟前 | 调试 · python · 异步编程 · Python asyncio introspection current_task all_tasks
- Python asyncio introspection 怎样定位当前任务
- 120浏览 收藏
-
- 文章 · python教程 | 1小时前 | 标准库 · Python教程 · Python 类型注解 Python 3.14 annotationlib get_annotations ForwardRef 延迟注解
- Python 3.14 annotationlib.get_annotations 怎样读取延迟注解
- 423浏览 收藏
-
- 文章 · python教程 | 1小时前 |
- Python 3.14 跨解释器 Queue.put 的阻塞与 QueueFull 处理方案
- 157浏览 收藏
-
- 文章 · python教程 | 18小时前 | xml · python · Python xml xml.etree.ElementTree canonicalize C14N
- Python xml.etree.ElementTree.canonicalize 怎样生成稳定的 XML 文本
- 151浏览 收藏
-
- 文章 · python教程 | 18小时前 | python · Python 弱引用 weakref getweakrefcount
- Python weakref.getweakrefcount 怎样查看对象关联的弱引用数量
- 248浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1144次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1129次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1306次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1245次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1097次使用
-
- Python TaskGroup 怎样让子任务失败统一收敛
- 2026-11-12 501浏览
-
- Python xml.dom.minidom.unlink 怎样释放不再使用的 DOM 树引用
- 2026-10-27 501浏览
-
- Python typing 怎样用 TypeIs 缩小类型
- 2026-10-24 501浏览
-
- Python sqlite3 Connection serialize 怎么导出数据库快照:备份窗口、内存占用与恢复校验
- 2026-08-26 501浏览
-
- Python监控网页状态:requests异常处理实战
- 2026-05-29 501浏览

