Go 1.16+ 的 embed 包支持编译时嵌入文件，需用变量声明 + //go:embed 指令绑定路径，路径须静态、存在且非符号链接；读取必须用 FS.Open，路径需严格匹配嵌入根目录。
Go 1.16+ 的 embed 包能直接将文件编译进二进制，无需外部依赖或运行时加载——但必须满足路径静态可判定、文件在构建时存在、且不能是 symlink 或动态生成内容，否则构建失败。
embed.FS 必须用变量声明，不能在函数内直接调用
embed.FS 是一个类型，不是函数；你不能写 embed.FS{"./static"} 或在 http.FileServer 里临时构造。它必须通过变量声明 + //go:embed 指令绑定：
import "embed"//go:embed static/* var staticFiles embed.FS
func main() { http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.FS(staticFiles)))) }
常见错误：把 //go:embed 放在函数内部、或放在未导出变量上（如 files 小写），会导致构建时静默忽略嵌入，运行时报 fs: file does not exist。
路径匹配规则严格，通配符不支持递归子目录
//go:embed 的 glob 模式只支持 *（单层）和 **（Go 1.22+ 才支持递归）。例如：
立即学习“go语言免费学习笔记（深入）”；
-
//go:embed templates/*.html→ 只匹配templates/下一级的 HTML 文件 -
//go:embed templates/**/*.html→ Go 1.22+ 才有效；1.16–1.21 会报错invalid pattern -
//go:embed assets/→ 合法，等价于assets/**（隐式递归，但仅限目录形式）
注意：assets/** 在旧版本中不可用，而 assets/ 虽然能嵌入整个目录，但访问时路径必须带前缀（如 assets/css/style.css），不能省略 assets/。
嵌入后读取文件需用 embed.FS.Open，不能用 os.Open
嵌入资源不在文件系统中，os.Open("static/index.html") 一定失败。必须用 FS.Open，且路径是相对于 embed 声明时的根路径：
data, err := staticFiles.ReadFile("static/index.html")
if err != nil {
// 注意：err 是 *fs.PathError，msg 类似 "open static/index.html: file does not exist"
}容易踩的坑：
- 路径开头多写了
/（如/static/index.html）→ 报错file does not exist - 嵌入时用了
//go:embed static/*，但读取时写成了index.html（漏了static/前缀） - 误以为
embed.FS支持ReadDir列出所有文件 —— 实际上它实现了fs.FS，但标准库中只有fs.ReadDir（Go 1.16+）可用，且返回的是fs.DirEntry列表，不是字符串名列表
最易被忽略的一点：嵌入路径是编译时相对 go build 执行目录计算的，不是相对于源文件位置。如果在子目录下执行 go build，而 //go:embed 指令里的路径是相对项目根的，就会找不到文件 —— 建议统一在项目根目录构建，或用 go:embed 配合固定相对路径（如 ./public/**）并保持结构稳定。
