如何调整tar命令参数匹配Node.js的tgz压缩结果？

问题的核心是默认tar -czf的打包逻辑和tar-fs的行为存在两处关键差异：一是打包路径结构，二是tar包格式/压缩参数。以下是调整后的tar命令：

tar -czf output.tgz -C path/to/folder --format=ustar --gzip-options=level=6 .

参数详解 #

• -C path/to/folder：切换到目标文件夹后再打包当前目录（.），这样打包的是文件夹内的所有内容，而非文件夹本身。这直接解决了系统找不到manifest.json的问题——原命令会把文件夹本身打包进去，导致解压后文件嵌套在子目录里，而黑盒系统期望文件在解压根目录。
• --format=ustar：指定tar包采用ustar格式，tar-fs默认生成的就是ustar格式的包，而macOS默认的bsdtar用的是posix格式，格式差异可能导致路径解析错误。
• --gzip-options=level=6：对齐gzip压缩级别，Node.js的zlib.createGzip()默认使用级别6的压缩，这会缩小两个压缩包的体积差异。

额外优化（若仍有问题） #

如果调整后还是存在兼容性问题，可以添加以下参数对齐文件元数据：

• --no-xattrs：禁用扩展属性，tar-fs默认不处理这类属性
• --atime-preserve：保留文件访问时间，和tar-fs的默认行为一致

内容的提问来源于stack exchange，提问作者Colin Fredericks