Golang在Ubuntu上打包时如何处理静态文件

在Golang项目里，静态文件怎么处理，一直是打包部署时绕不开的一个环节。简单来说，要么把静态资源直接塞进最终的二进制文件里，省去部署时再单独拷贝的麻烦；要么还是老办法，把静态文件复制到一个指定目录，运行时从磁盘读取。下面就以Ubuntu环境为例，把这两种主流做法掰开揉碎讲清楚。

方法1：将静态文件嵌入到二进制文件中

如果你是Go 1.16及以上版本，那embed包就派上用场了。它能把指定目录下的所有文件，在编译时直接打包进二进制文件，运行时就像一个内置的文件系统一样。看个例子：

package main

import (
	"embed"
	"net/http"
)

//go:embed static/*
var staticFiles embed.FS

func main() {
	http.Handle("/", http.FileServer(http.FS(staticFiles)))
	http.ListenAndServe(":8080", nil)
}

这里//go:embed static/*指令告诉编译器，把static目录下的所有文件都嵌入到staticFiles这个变量里。然后通过http.FileServer配合http.FS包装一下，就能像普通静态文件服务一样使用了。好处很明显：部署时只需要一个二进制文件，不需要额外操心静态文件路径问题。

方法2：将静态文件复制到一个特定的目录中

如果你不想用嵌入，或者项目里有些文件需要动态更新（比如模板、配置文件），那传统的方式依然可靠。在程序启动时，先把静态文件从源目录拷贝到目标目录，再启动HTTP服务。示例代码如下：

package main

import (
	"io/fs"
	"net/http"
	"os"
	"path/filepath"
)

func main() {
	staticDir := "static"

	// 如果目标目录不存在，先创建
	if _, err := os.Stat(staticDir); os.IsNotExist(err) {
		os.Mkdir(staticDir, os.ModePerm)
	}

	// 将静态文件从源目录复制到目标目录
	copyStaticFiles("path/to/your/static/files", staticDir)

	http.Handle("/", http.FileServer(http.Dir(staticDir)))
	http.ListenAndServe(":8080", nil)
}

func copyStaticFiles(src, dst string) error {
	srcFs, err := fs.Sub(fs.Os, src)
	if err != nil {
		return err
	}
	return fs.WalkDir(srcFs, ".", func(path string, d fs.DirEntry, err error) error {
		if err != nil {
			return err
		}
		relPath, err := filepath.Rel(src, path)
		if err != nil {
			return err
		}
		dstPath := filepath.Join(dst, relPath)
		if d.IsDir() {
			return os.MkdirAll(dstPath, d.Info().Mode())
		} else {
			srcFile, err := os.Open(path)
			if err != nil {
				return err
			}
			defer srcFile.Close()
			dstFile, err := os.Create(dstPath)
			if err != nil {
				return err
			}
			defer dstFile.Close()
			_, err = srcFile.WriteTo(dstFile)
			if err != nil {
				return err
			}
		}
		return nil
	})
}

这段代码的逻辑不复杂：先检查目标目录是否存在，不存在就创建；然后利用fs.WalkDir遍历源目录，递归复制所有文件和子目录到目标目录。最后和嵌入方式一样，用http.FileServer提供服务。区别在于，这里的静态文件是物理存在于磁盘上的，可以随时替换。

打包时，标准做法就是用go build指定目标平台和架构：

GOOS=linux GOARCH=amd64 go build -o myapp main.go

这条命令会在当前目录生成一个名为myapp的可执行文件。注意，如果你用的是方法2（复制目录），那么在运行这个二进制文件之前，必须确保静态文件目录已经正确设置，并且源目录存在。否则程序启动后找不到静态文件，就会报404。