shutil.make_archive打包失败主因是root_dir与base_dir路径关系错误：base_dir必须为相对路径，root_dir为其父目录，否则静默生成空包；跨平台应选format="zip"；中文路径需用7-Zip重压或提示用户使用兼容解压工具。
shutil.make_archive 打包目录时路径写错就静默失败
它不会报错，但生成的 zip 是空的或根本没文件——因为 root_dir 默认是当前工作目录，而 base_dir 是相对于它的子路径。你传了个绝对路径当 base_dir，它会去 root_dir 下找那个“子目录”，自然找不到。
- 正确做法：用
base_dir指定要打包的目录名（不带路径），再用root_dir指定它的父目录 - 比如要打包
/home/user/project，就设root_dir="/home/user"，base_dir="project" - 如果
base_dir是"./project"或"/home/user/project"，大概率打空包 - 调试时加一句
print(os.path.join(root_dir, base_dir))确认拼出来的是不是你要的目录
压缩格式选 tar 还是 zip？Windows 和 Linux 行为不一致
shutil.make_archive 的 format 参数看着简单，实际背后调用的是不同模块："zip" 走 zipfile，"tar" 走 tarfile，而 "gztar" 会额外依赖系统 gzip 命令（Linux/macOS 可用，Windows 默认没有）。
- 跨平台备份首选
format="zip"：Python 自带支持，Windows 解压也最省心 - 要压缩率高且目标环境有
tar工具，用"gztar"，但得先确认shutil.which("gzip")返回非None -
"bztar"和"xztar"同理，别默认写上，容易在 CI 或 Docker 容器里挂掉
中文路径或特殊字符文件名在 zip 里乱码
这是 zipfile 模块的老问题：Python 3.6+ 默认用 UTF-8 写文件名，但 Windows 资源管理器老版本只认 CP437 或 GBK。结果就是解压后文件名变问号或方块。
- 临时解法：打包完用
7z a -tzip -encoding=utf8 backup.zip project/重压（需装 7-Zip） - 纯 Python 方案目前无官方支持，别硬改
zipfile源码 - 如果目标用户全是 macOS/Linux，可忽略；若含 Windows 用户，建议在备份脚本里加提示：“请用 Bandizip、7-Zip 或最新版 WinRAR 解压”
想排除某些子目录（如 __pycache__、.git）得自己遍历
shutil.make_archive 没有 exclude 参数，也不能传 ignore_patterns。它只会原样递归打包整个 base_dir 下所有内容。
立即学习“Python免费学习笔记（深入）”；
- 安全做法：先用
shutil.copytree复制一份干净目录（配合ignore函数过滤），再对副本打包 - 示例忽略逻辑：
shutil.copytree(src, tmp_dir, ignore=shutil.ignore_patterns("__pycache__", ".git", "*.log")) - 别图省事用
os.system("rm -rf")删除，容易误删；也别用shutil.rmtree直接删原目录 - 临时目录记得用
tempfile.mkdtemp()创建，避免路径冲突
真正麻烦的不是怎么调用函数，而是 root_dir 和 base_dir 的相对关系、中文编码的隐性依赖、还有那些看似能绕过实则埋雷的“快捷写法”。跑通一次不等于以后都稳。
