Buffalo框架不原生支持YAML配置，仅识别toml、json和env格式；若需使用config.yml，须手动通过gopkg.in/yaml.v3解析并注入环境变量，或改用Viper库接管配置加载。
Buffalo 框架本身不直接解析 YAML 配置文件；它默认只识别 toml、json 和 env 格式。如果你的项目里有 config.yml，Buffalo 启动时会直接忽略它，不会报错，但也不会加载任何配置——这是最常被踩的坑。
Buffalo 的 config 加载机制只认特定后缀
Buffalo 通过 github.com/gobuffalo/envy 加载环境配置，其硬编码支持的格式只有：toml、json、env（即 .env 文件）。YAML 不在白名单中，哪怕你把文件命名为 config.yaml 或 database.yml，Buffalo 的 app.New() 或 envy.Load() 都不会处理它。
- 默认查找路径是：根目录下的
config/buffalo-app.toml（或.json/.env） -
envy.Load()内部调用的是go-toml或go-json，完全不涉及gopkg.in/yaml.v3等 YAML 库 - 即使你在
actions/app.go里手动 importgopkg.in/yaml.v3，Buffalo 的启动流程也不会自动触发它
想用 YAML？得绕过 Buffalo 原生 config 加载
必须自己读取并注入。常见做法是：在 app.New() 之前，用标准 YAML 库解析文件，再把结果写入 os.Setenv() 或覆盖 buffalo.App.Env，让后续逻辑能感知到。
- 先加依赖：
go get gopkg.in/yaml.v3 - 在
app.go开头（app.New()调用前）插入：
import "gopkg.in/yaml.v3"
// ...
func app() *buffalo.App {
// 手动加载 config.yml
data, _ := os.ReadFile("config.yml")
var cfg map[string]interface{}
yaml.Unmarshal(data, &cfg)
// 注入到环境变量（仅对字符串值有效）
for k, v := range cfg {
if s, ok := v.(string); ok {
os.Setenv(strings.ToUpper(k), s)
}
}
// 或者直接赋值给全局变量 / 结构体供后续使用
// ...
return buffalo.New(buffalo.Options{...})
}
注意：os.Setenv() 只能传字符串，复杂嵌套结构（如数据库 URL + 用户名 + 密码分开）得自己拆解或改用结构体绑定。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
更稳妥的做法：用 Viper 替代 Buffalo 的 config 系统
Viper 是 Go 生态事实标准的配置库，原生支持 YAML，并能无缝对接 Buffalo 的生命周期。你不需要放弃 Buffalo，只需接管配置加载环节。
- 初始化 Viper（在
app.go最顶部）：
import "github.com/spf13/viper"
// ...
viper.SetConfigName("config")
viper.SetConfigType("yaml")
viper.AddConfigPath("config/") // 假设 config.yml 在 config/ 目录下
err := viper.ReadInConfig()
if err != nil {
log.Fatal("读取 config.yml 失败:", err)
}
// 然后在 app.New() 前，用 viper.GetString("db.host") 等方式取值
关键点：Viper 读取后，你可以把关键字段（如 viper.GetString("env")）传给 buffalo.Options{Env: ...}，确保 Buffalo 的环境判断逻辑仍正常工作。
真正容易被忽略的是：Buffalo 的 dev / test / production 环境切换依赖 BUFFALO_ENV 环境变量或 GO_ENV，而不是配置文件里的 env: 字段——哪怕你 YAML 里写了 env: production，Buffalo 也看不到。这个脱节必须手动桥接。
