无法理解Go embed用法：嵌入目录后无法读取文件内容

你的问题根源在于Go embed指令的写法错误，导致.config目录下的内容没有被完整嵌入到二进制文件中，同时需要确保文件读取逻辑基于embed.FS而非本地文件系统。

1. 修正Embed指令 #

你当前使用的//go:embed all:.config仅会嵌入.config目录本身（all:前缀仅允许嵌入隐藏目录），但不会递归嵌入目录内的所有文件和子目录。要完整嵌入整个.config目录树（包括隐藏文件），需要使用递归匹配语法：

// 嵌入.config目录下所有非隐藏文件和子目录
//go:embed .config/**
var configFiles embed.FS

如果需要包含.config目录下的隐藏文件/目录（比如.config/.env），补充all:前缀指定隐藏项：

// 嵌入所有内容，包括隐藏文件和目录
//go:embed .config/** all:.config/.*
var configFiles embed.FS

2. 确保文件读取逻辑正确 #

你的show函数必须通过传入的embed.FS实例读取文件，不能直接使用os.Open（否则会读取本地文件系统，导致项目内看似正常、项目外失效的情况）。修改show函数如下：

func show(fs embed.FS, path string) error {
    content, err := fs.ReadFile(path)
    if err != nil {
        fmt.Printf("读取文件失败 %s: %v\n", path, err)
        return err
    }
    fmt.Printf("文件 %s 内容:\n%s\n", path, string(content))
    return nil
}

在ls函数中调用时传入embed.FS实例：

if !d.IsDir() {
    show(files, path) // 传入embed.FS，确保读取嵌入的内容
}

3. 完整修正后的代码示例 #

package main

import (
	"embed"
	"fmt"
	"io/fs"
)

//go:embed .config/** all:.config/.*
var configFiles embed.FS

func main() {
	if err := ls(configFiles); err != nil {
		fmt.Printf("遍历文件出错: %v\n", err)
	}
}

func ls(files embed.FS) error {
	return fs.WalkDir(files, ".", func(path string, d fs.DirEntry, err error) error {
		if err != nil {
			return err
		}
		if !d.IsDir() {
			return show(files, path)
		}
		return nil
	})
}

func show(fs embed.FS, path string) error {
	content, err := fs.ReadFile(path)
	if err != nil {
		return fmt.Errorf("读取 %s: %w", path, err)
	}
	fmt.Printf("=== %s ===\n%s\n", path, content)
	return nil
}

验证方法 #

编译二进制文件后，将其移动到项目目录外运行，此时会读取嵌入到二进制中的.config目录内容，而非本地文件系统，确保所有文件都能被正确列出和读取。

内容的提问来源于stack exchange，提问作者tomcam