首页 > 脚本专栏 > Golang > Go embed指令嵌入静态文件到二进制包

Go embed指令嵌入静态文件到二进制包实现方式

2026-06-23 10:19:40 作者：程序员老狼

了解embed指令在Gin框架中的的应用方法,探讨如何将静态资源嵌入编译包,简化网页模板打包流程,通过实例解析常规用用法、路径支持及错误处理,提供实用编程技巧与经验分享

Go embed指令嵌入静态文件到二进制包

go 1.16开始提供了embed指令 , 可以将静态资源嵌入到编译包里面

这样就可以把网页模板等文件直接打包了，就不需要每次还要拷贝静态文件

常规用法

import _ "embed"
//go:embed hello.txt
var s string
func main() {
 print(s)
}

作为一个文件路径

也支持多个，以及通配符

//go:embed hello1.txt hello2.txt
var f embed.FS
func main() {
 data1, _ := f.ReadFile("hello1.txt")
 fmt.Println(string(data1))
 data2, _ := f.ReadFile("hello2.txt")
 fmt.Println(string(data2))
}

但是

路径里面不能包含 . .. 这种相对路径的符号否则报错 , 也不能以/ 开头

这就意味着 , 如果模板文件在单独的目录里 , 那么需要有个go的包以及go文件对外提供全局变量

类似我这样

package static
import "embed"
//go:embed templates/*
var TemplatesEmbed embed.FS
//go:embed js/*
var JsEmbed embed.FS

如果与gin的模板渲染配合使用

templ := template.Must(template.New("").ParseFS(static.TemplatesEmbed, "templates/*.html"))
engine.SetHTMLTemplate(templ)

渲染模板的时候就可以直接来 , 模板的路径是在 ./static/templates/index.html

    c.HTML(http.StatusOK, "index.html", gin.H{
        "Title":    title,
    })

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。