项目打包

pzip教程

项目打包

先扫描归档计划,再生成 ZIP。把 my-project 换成实际项目目录。

slothtool pzip ./my-project --dry-run --json
slothtool pzip ./my-project

默认在源目录同级生成 my-project.zip,归档顶层为 my-project/。目标已存在时改用时间戳名称,不覆盖。用 --output ./releases/my-project 自定义路径,缺少 .zip 时补齐;输出不能放在源目录内部。

过滤规则

默认排除任意深度的 .DS_Store 文件,以及 __MACOSX、dist、target、.git 目录。不自动排除所有依赖目录;node_modules 是否进入归档,还取决于项目 .gitignore 或额外规则。

slothtool pzip config show
slothtool pzip config rule target off
slothtool pzip config add "reports/"
slothtool pzip config remove "reports/"
slothtool pzip ./my-project --exclude "*.log" --dry-run

--exclude 只影响本次,支持重复传入;config add 保存长期模式。自定义模式只增加排除,不接受绝对路径或以 ! 开头的重新包含规则。

根部和子目录的 .gitignore 都会读取,按各自目录解释。否定规则不能绕过仍开启的内置过滤;关闭 target 内置规则后,它仍可能被 gitignore 排除。config reset 清除配置定制,不取消项目 gitignore。

检查交付物

预演查看过滤汇总和 warnings;生成后查看 ZIP 文件列表,并在空目录试解压。默认过滤不是秘密扫描,不能保证排除 .env、私钥和业务数据。

pzip 保留空目录,但跳过符号链接并告警。没有可打包文件、输入不可读或输出不合法时失败;它不等价于完整文件系统备份。