Go1.16新特性embed打包静态资源文件实现

目录

背景

相信有一部分人喜爱>

因此，GO 社区发起了一个期望 Go 编译器支持嵌入静态文件的提案issue#35950。现在，这个功能将随着 1.16 版本一起发布，目前最新的版本是 Go 1.16 RC1 预览版。

好了，接下来我们详细介绍 go embed 的各个功能。

embed>

└── cmd 测试目录
    ├── assets 静态资源目录
    │   ├── .idea.txt
    │   ├── golang.txt
    │   └── hello.txt
    └── main.go  测试go源文件

字符串、字节切片、文件嵌入

package main
import (
	"embed"
	_ "embed"
	"fmt"
)
//go:embed指令用来嵌入，必须紧跟着嵌入后的变量名
//只支持嵌入为string, byte slice和embed.FS三种类型，这三种类型的别名(alias)和命名类型(如type S string)都不可以
//以字符串形式嵌入 assets/hello.txt
//go:embed assets/hello.txt
var s string
//文件的内容嵌入为slice of byte，也就是一个字节数组
//go:embed assets/hello.txt
var b []byte
//嵌入为一个文件系统 新的文件系统FS
//go:embed assets/hello.txt
//go:embed assets/golang.txt
var f embed.FS
func main() {
	fmt.Println("embed string.", s)
	fmt.Println("embed byte.", string(b))
	data, _ := f.ReadFile("assets/hello.txt")
	fmt.Println("embed fs.", string(data))
	data, _ = f.ReadFile("assets/golang.txt")
	fmt.Println("embed fs.", string(data))
}

编译运行后输出：

embed string. hello golang!
embed byte. hello golang!
embed fs. hello golang!
embed fs. hello!

从上面的代码可以看出，embed 支持嵌入为 string,byte slice 和 embed.FS 这三种类型，另外也不允许从这些类型中派生哦。

嵌入文件

对于>

//go:embed assets/hello.txt
//go:embed assets/golang.txt
var f embed.FS

当然也支持，两个变量嵌入一个文件。虽然两个变量嵌入了同一个文件，但它们在编译的时候会独立分配，彼此之间并不会互相影响。

嵌入文件夹

FS>

//go:embed assets
var f embed.FS
func main() {
	data, _ := f.ReadFile("assets/hello.txt")
	fmt.Println(string(data))
}

嵌入匹配

go:embed>

如果想嵌入.和_开头的文件和文件夹， 比如.hello.txt 文件，那么就需要使用*，比如 go:embed assets/*。

不具有递归性，所以子文件夹下的.和_不会被嵌入，除非你在专门使用子文件夹的进行嵌入:

├── assets
│   ├── .idea.txt
│   ├── golang.txt
│   └── hello.txt
└── main.go
package main
import (
	"embed"
	_ "embed"
	"fmt"
)
//go:embed assets/*
var f embed.FS
func main() {
	data, _ := f.ReadFile("assets/.idea.txt")
	fmt.Println(string(data))
}

FS>

embed.FS 实现了 io/fs.FS 接口，它可以打开一个文件，返回 fs.File:

package main
import (
	"embed"
	_ "embed"
	"fmt"
)
//go:embed assets
var f embed.FS
func main() {
	helloFile, _ := f.Open("assets/hello.txt")
	stat, _ := helloFile.Stat()
	fmt.Println(stat.Name(), stat.Size())
}

它还提供了 ReadFileh 和 ReadDir 功能，遍历一个文件下的文件和文件夹信息：

package main
import (
	"embed"
	_ "embed"
	"fmt"
)
//go:embed assets
var f embed.FS
func main() {
	dirEntries, _ := f.ReadDir("assets")
	for _, de := range dirEntries {
		fmt.Println(de.Name(), de.IsDir())
	}
}

因为它实现了 io/fs.FS 接口，所以可以返回它的子文件夹作为新的文件系统：

package main
import (
	"embed"
	_ "embed"
	"fmt"
	"io/fs"
	"io/ioutil"
)
//go:embed assets
var f embed.FS
func main() {
	as, _ := fs.Sub(f, "assets")
	hi, _ := as.Open("hello.txt")
	data, _ := ioutil.ReadAll(hi)
	fmt.Println(string(data))
}

总结：

对于单个的文件，支持嵌入为字符串和>对于多个文件和文件夹，支持嵌入为新的文件系统 FSgo:embed 指令用来嵌入，必须紧跟着嵌入后的变量名只支持嵌入为 string, byte slice 和 embed.FS 三种类型，类型派生也不可以。

以上就是Go 1.16新特性embed打包静态资源文件实现的详细内容，更多关于Go embed打包静态资源的资料请关注易采站长站其它相关文章！