golang 中使用 tar 包打包文件时正确保留原始权限的完整指南：go 的 `archive/tar` 包默认不自动继承文件权限，需显式通过 `tar.fileinfoheader` 构建包含 mode、mtime 等元信息的 header，否则解压后文件权限将丢失（如变为 000），导致无法读取。
在 Go 中手动构造 tar 归档时，一个常见误区是仅设置 Header.Name 和 Header.Size 字段（如问题代码所示），而忽略文件权限（Mode）、修改时间（ModTime）、用户/组 ID（Uid/Gid）等关键元数据。这会导致生成的 tar 文件中对应条目权限位为 000，解压后目标文件不可读、不可执行，必须额外执行 chmod 才能使用。
✅ 正确做法：使用 tar.FileInfoHeader
tar.FileInfoHeader(fi, link) 是标准库提供的工具函数，它会基于 os.FileInfo 自动填充完整的 header 字段，包括：
- Mode（含权限位与文件类型，如 0644 或 0755）
- ModTime
- Uid / Gid
- Size
- Typeflag（自动识别普通文件、目录、符号链接等）
hdr, err := tar.FileInfoHeader(fi, "")
if err != nil {
log.Fatalln("failed to create header:", err)
}⚠️ 注意：fi.Name() 仅返回文件名（不含路径），因此若需归档带路径的文件（如 "data/config.json"），必须手动修正 hdr.Name：
hdr.Name = "data/config.json" // 覆盖默认的 base name
✨ 进阶优化：避免内存加载，用 io.Copy
原代码调用 ioutil.ReadFile() 将整个文件读入内存，对大文件极不友好。应直接流式写入：
立即学习“go语言免费学习笔记（深入）”；
// ✅ 推荐：零拷贝、低内存占用
_, err := io.Copy(tw, f)
if err != nil {
log.Fatalln("failed to write file content:", err)
}完整修复版示例（含错误处理与日志）：
package main
import (
"archive/tar"
"io"
"log"
"os"
)
func main() {
// 创建 tar 输出文件
outFile, err := os.Create("/path/to/tar/file/test.tar")
if err != nil {
log.Fatalln("failed to create tar file:", err)
}
defer outFile.Close()
tw := tar.NewWriter(outFile)
defer tw.Close() // 确保 Close() 被调用，完成归档尾部写入
// 打开源文件
f, err := os.Open("sample.txt")
if err != nil {
log.Fatalln("failed to open source file:", err)
}
defer f.Close()
fi, err := f.Stat()
if err != nil {
log.Fatalln("failed to stat file:", err)
}
// ✅ 关键：用 FileInfoHeader 自动填充权限等元数据
hdr, err := tar.FileInfoHeader(fi, "")
if err != nil {
log.Fatalln("failed to create header:", err)
}
hdr.Name = "sample.txt" // 显式设置归档内路径（可扩展为子目录）
if err := tw.WriteHeader(hdr); err != nil {
log.Fatalln("failed to write header:", err)
}
// ✅ 流式写入，高效且内存安全
written, err := io.Copy(tw, f)
if err != nil {
log.Fatalln("failed to copy file content:", err)
}
log.Printf("Successfully archived %s (%d bytes)", hdr.Name, written)
}? 验证权限是否生效
打包后可通过命令行验证：
# 查看 tar 中文件权限 tar -tvf /path/to/tar/file/test.tar # 解压并检查 tar -xvf test.tar ls -l sample.txt # 应显示如 -rw-r--r--（即 0644）
? 总结要点
- ❌ 错误：手动构造 tar.Header 且只设 Name/Size → 权限丢失；
- ✅ 正确：始终优先使用 tar.FileInfoHeader(fi, link)；
- ? 路径处理：FileInfoHeader 不含路径，需手动赋值 hdr.Name 以支持目录结构；
- ⚡ 性能：用 io.Copy 替代 ioutil.ReadFile + tw.Write，避免 OOM；
- ? 清理：务必 defer tw.Close() —— 它会写入 tar 结束标记，缺失将导致解压失败。
遵循以上实践，即可生成符合 POSIX 权限语义、跨平台兼容的标准 tar 归档。
