使用 Go 开发应用的时候,有时会遇到需要读取静态资源的情况。比如开发 Web 应用,程序需要加载模板文件生成输出的 HTML。在程序部署的时候,除了发布应用可执行文件外,还需要发布依赖的静态资源文件。这给发布过程添加了一些麻烦。既然发布单独一个可执行文件是非常简单的操作,就有人会想办法把静态资源文件打包进 Go 的程序文件中。
安装工具
安装打包工具 go-bindata 到GOPATH/bin
中
# ... 检查所有目录下的main包编译可执行文件
go get -u github.com/jteeuwen/go-bindata/...
如果使用 go mod 一定要在项目外执行安装,因为这不是项目的代码依赖,同时需要指定为 master 分支,默认是安装最新的 tag,但是最新的 tag 的代码太老了,缺少AssetInfo()
方法
go get -u github.com/jteeuwen/go-bindata/...@master
安装依赖
go-bindata
只是把静态文件转化成 go 文件,在代码中读取这些静态文件需要使用go-bindata-assetfs
go get -u github.com/elazarl/go-bindata-assetfs
使用
切换到项目路径下,这里一个 web 服务器为例,所有静态资源放在 www 目录下
执行go-bindata -o=data/data.go -pkg=data www/...
这句话的意思是把 www 目录下所有文件生成为一个 go 文件,放置到data/data.go
,文件的包名为data
package main
import (
"github.com/elazarl/go-bindata-assetfs"
"github.com/tmaize/bindata/data"
"net/http"
)
func main() {
// 重新实现文件接口
files := assetfs.AssetFS{
Asset: data.Asset,
AssetDir: data.AssetDir,
AssetInfo: data.AssetInfo,
Prefix: "www", // 访问文件1.html = > 访问文件 www/1.html
}
// http.Handle("/", http.FileServer(http.Dir("./www")))
http.Handle("/", http.FileServer(&files))
http.ListenAndServe(":8899", nil)
}
可以看到引入了生成的data.go
,最终在http.FileServer
中传入自己实现的文件系统,使得在访问文件时找到对应的字符编码,再转换为文件流
说明
go-bindata
是一个工具,使用把静态文件生成 go 代码,文件以 byte 数组的形式存在,项目并不依赖改项目,而是依赖该工具生成的 go 文件
go-bindata-assetfs
是文件系统接口的实现,从生成的 go 文件中拿文件数据
如果只需要简单地读文件,可以不使用go-bindata-assetfs
,因为go-bindata
生成的 go 文件本身提供的一些方法返回文件的[]byte
内容,可以根据需求自已去拿
每次静态文件改动的话在打包前记得重新执行go-bindata
命令