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,
})总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。


最新评论