直接在add()中传入filter函数是最可靠方式，该函数接收TarInfo对象，返回修改后的TarInfo或None（跳过）；需用路径组件拆解精准匹配如parts[0] in ('.git', '__pycache__')或'node_modules' in parts，避免字符串包含误判。
tarfile压缩时如何跳过指定子目录？
直接在 add() 调用中传入 filter 参数是最可靠的方式，而不是靠手动遍历路径判断——后者容易漏掉符号链接、硬链接或权限异常的条目。
核心思路是：提供一个函数，接收 TarInfo 对象，返回修改后的 TarInfo 或 None（表示跳过）。返回 None 就等于排除该条目。
-
filter函数必须接收单个TarInfo参数，不能带额外参数（如想排除__pycache__和.git，得在函数内部硬编码或闭包捕获） - 路径判断要用
tarinfo.name，它始终是 POSIX 风格的正斜杠路径，即使在 Windows 上也无需转义反斜杠 - 注意前导
/：tarinfo.name在归档中不带盘符或绝对根，例如"src/__pycache__/foo.pyc"，不是"/src/__pycache__/foo.pyc"
写一个安全的 exclude_filter 函数
别用字符串 in 简单匹配（比如 "__pycache__" in tarinfo.name），这会误杀 my__pycache__backup 这类名字。应该用路径组件拆解或前缀匹配。
import tarfile
import os
<p>def exclude_filter(tarinfo):
name = tarinfo.name.rstrip('/')
parts = name.split('/')</p><h1>排除顶层名为 .git 或 <strong>pycache</strong> 的目录及其全部内容</h1><pre class="brush:php;toolbar:false;">if parts[0] in ('.git', '__pycache__'):
return None
# 排除任何层级下名为 node_modules 的目录（只要路径中某一级是 node_modules）
if 'node_modules' in parts:
return None
return tarinfowith tarfile.open('archive.tar.gz', 'w:gz') as tar: tar.add('project/', filter=exclude_filter)
注意：tarinfo.name 末尾可能带 /（表示目录），rstrip('/') 是为了统一处理；parts[0] 是归档内相对路径的最外层目录名，不是原始磁盘路径。
立即学习“Python免费学习笔记（深入）”；
为什么不用 shutil.make_archive？
shutil.make_archive() 不支持 filter，也没有暴露底层 tarfile 实例，无法精细控制排除逻辑。它底层确实调用 tarfile，但封装太死。
- 如果你只需求简单排除（比如整个文件夹），
shutil.make_archive()+ignore_patterns可行，但它只支持 glob 模式，且对嵌套目录的排除不可靠（比如"**/node_modules"在旧版 Python 中不生效） -
tarfile的filter是唯一能精确控制每个条目是否进入归档的机制，包括设备文件、socket、broken symlink 等特殊项的处理 - gzip 压缩率和 chunk 大小等细节也仅通过
tarfile可调，shutil全部黑盒
常见坑：排除后 size 不变或报错
压缩后体积没变小？大概率是 filter 返回了原 tarinfo 而没改 type 或 size，但更可能是你排除的是空目录——tar 格式本身不存空目录，它们只是靠父目录条目隐含存在，所以删掉空目录不会减少字节数。
- 检查是否误判了路径：打印
tarinfo.name和tarinfo.type（tarfile.DIRTYPE是'5'，tarfile.REGTYPE是'0'），确认被跳过的确实是目标目录 - 如果遇到
OSError: [Errno 2] No such file or directory，说明某个tarinfo指向已删除或权限不足的路径——filter函数里不要做os.stat()，tarfile自己会在 add 时读取，你只需决定是否让它进归档 - 排除符号链接目标（而非链接本身）？不行。
tarinfo描述的是链接文件自身，不是它指向的内容。要排除目标，得先解析链接再比对，但通常没必要——链接文件体积极小，排除意义不大
真正难处理的是跨文件系统挂载点或 bind mount，tarfile 默认不跟随，也不会报错，只会跳过——这种场景得靠外部 find + --prune 预筛选路径列表，再逐个 add()。
