Go语言中使用archive/tar包保留文件权限（详解tar打包时如何正确处理文件权限）

为什么文件权限很重要？

在 Unix/Linux 系统中，文件权限决定了谁可以读取、写入或执行某个文件。例如，一个可执行脚本如果没有设置正确的执行权限（如 755），那么即使被正确解压，也无法直接运行。因此，在使用 Go语言 tar包 打包文件时，保留原始权限是保证系统行为一致性的关键。

Go 中 tar.Header 的 Mode 字段

在 archive/tar 包中，每个归档条目由 tar.Header 结构体表示。其中有一个关键字段：Mode，它用于存储文件的权限和类型信息（如普通文件、目录、符号链接等）。

要保留原始文件的权限，我们需要从源文件的 os.FileInfo 中提取权限，并将其赋值给 tar.Header.Mode。

完整示例：打包并保留文件权限

下面是一个完整的 Go 程序，演示如何使用 archive/tar 和 os 包来创建一个保留文件权限的 tar 归档文件：

package mainimport (	"archive/tar"	"fmt"	"io"	"os"	"path/filepath")// addToTar 将单个文件添加到 tar writer 中func addToTar(tw *tar.Writer, filePath string) error {	file, err := os.Open(filePath)	if err != nil {		return err	}	defer file.Close()	// 获取文件信息	info, err := file.Stat()	if err != nil {		return err	}	// 构建 tar header	header, err := tar.FileInfoHeader(info, "")	if err != nil {		return err	}	// 可选：自定义文件在 tar 中的路径名	header.Name = filepath.Base(filePath)	// 写入 header	if err := tw.WriteHeader(header); err != nil {		return err	}	// 复制文件内容到 tar	_, err = io.Copy(tw, file)	return err}func main() {	// 创建输出 tar 文件	tarFile, err := os.Create("output.tar")	if err != nil {		panic(err)	}	defer tarFile.Close()	tw := tar.NewWriter(tarFile)	defer tw.Close()	// 要打包的文件列表	files := []string{"script.sh", "config.txt"}	for _, file := range files {		fmt.Printf("Adding %s to tar...\n", file)		if err := addToTar(tw, file); err != nil {			fmt.Printf("Error adding %s: %v\n", file, err)		}	}	fmt.Println("Tar archive created with preserved file permissions!")}

关键点在于 tar.FileInfoHeader(info, "") 这一行。该函数会自动从 os.FileInfo 中提取包括权限在内的元数据，并填充到 tar.Header 中。这样，生成的 tar 文件就包含了原始文件的权限信息。

验证权限是否保留

你可以通过以下命令验证生成的 tar 文件是否保留了权限：

tar -tvf output.tar

输出中你会看到类似这样的内容：

-rwxr-xr-x user/group  123 2024-06-01 10:00 script.sh-rw-r--r-- user/group   45 2024-06-01 10:00 config.txt

注意第一列（如 -rwxr-xr-x）就是文件权限，说明我们的 文件权限保留 成功了！

常见误区

• ❌ 手动硬编码 header.Mode = 0644 —— 这会覆盖原始权限。
• ❌ 忽略 FileInfoHeader —— 直接 new 一个 Header 会导致权限丢失。
• ✅ 正确做法：始终使用 tar.FileInfoHeader(os.FileInfo, link) 来初始化 Header。

总结

通过本文，你已经学会了如何在 Go语言 中使用 archive/tar 包正确保留文件权限。记住核心要点：使用 tar.FileInfoHeader 自动提取权限，并确保在写入 tar 时包含完整的 Header 信息。这样，无论你是打包配置文件、脚本还是二进制程序，都能保证解压后的文件行为与原始文件一致。

掌握这一技巧，不仅能提升你的 Go 编程能力，还能让你开发的工具更加健壮可靠。希望这篇关于 Go archive/tar 的教程对你有所帮助！