通过压缩服务器端生成的目录为 zip 或 tar 归档文件，并以 http 响应流式传输，是安全、兼容且高效地向用户交付多层级文件结构的标准做法。
通过压缩服务器端生成的目录为 zip 或 tar 归档文件，并以 http 响应流式传输，是安全、兼容且高效地向用户交付多层级文件结构的标准做法。
在 Web 服务中，直接“提供整个目录”下载并不被 HTTP 协议原生支持——浏览器无法解析裸目录结构，也无法安全地遍历服务端路径。因此，正确的实践是：在服务端动态打包目标目录为归档文件（如 .zip 或 .tar.gz），设置合适的响应头，并将归档内容流式写入 HTTP 响应体。
以下是一个使用 Go（net/http + archive/zip）实现的完整示例，用于将任意服务器端目录打包为 ZIP 并触发浏览器下载：
package main
import (
"archive/zip"
"io"
"net/http"
"os"
"path/filepath"
"strings"
)
func serveDirectoryAsZip(w http.ResponseWriter, r *http.Request) {
dirPath := "/path/to/your/generated/dir" // 替换为实际路径
// 设置响应头，触发下载（注意：filename 应做安全转义，此处简化）
w.Header().Set("Content-Type", "application/zip")
w.Header().Set("Content-Disposition", `attachment; filename="export.zip"`)
zipWriter := zip.NewWriter(w)
defer zipWriter.Close()
// 递归遍历目录并写入 ZIP
filepath.Walk(dirPath, func(filePath string, info os.FileInfo, err error) error {
if err != nil {
return err
}
// 跳过目录本身（只处理文件）
if info.IsDir() {
return nil
}
// 计算 ZIP 中的相对路径（避免绝对路径泄露）
relPath, err := filepath.Rel(dirPath, filePath)
if err != nil {
return err
}
// 创建 ZIP 文件头（注意：路径分隔符统一为 '/'，兼容跨平台）
header, err := zip.FileInfoHeader(info)
if err != nil {
return err
}
header.Name = strings.ReplaceAll(relPath, `\`, `/`) // Windows 兼容
header.Method = zip.Deflate
writer, err := zipWriter.CreateHeader(header)
if err != nil {
return err
}
// 复制文件内容
file, err := os.Open(filePath)
if err != nil {
return err
}
defer file.Close()
_, err = io.Copy(writer, file)
return err
})
// 确保 ZIP 结束标记写入（关键！否则客户端可能解压失败）
zipWriter.Close()
}
func main() {
http.HandleFunc("/download", serveDirectoryAsZip)
http.ListenAndServe(":8080", nil)
}✅ 关键注意事项：
- 路径安全：务必使用 filepath.Rel() 获取相对路径，禁止将用户可控输入拼接到 dirPath，防止路径遍历（如 ../../../etc/passwd）；
- 文件名编码：生产环境需对 Content-Disposition 中的 filename* 使用 RFC 5987 编码支持中文等 Unicode 字符；
- 大目录处理：对于超大目录，建议启用 zipWriter.RegisterCompressor(zip.Deflate, ...) 并考虑分块写入或异步生成+预签名 URL；
- 权限与符号链接：默认 zip.FileInfoHeader 不保留 Unix 权限或软链接内容，如需高级控制，可手动构造 zip.FileHeader；
- 替代格式：若目标客户端为 Linux/macOS 用户居多，可提供 .tar.gz（用 archive/tar + compress/gzip），但 ZIP 兼容性更广。
总结：压缩归档不是权宜之计，而是符合 HTTP 语义、跨平台可靠、易于实现和验证的最佳实践。拒绝裸目录暴露，拥抱结构化交付。
