Buffalo 的 buffalo plugins install 仅支持极少数官方插件（如 buffalo-pop），本质是代码复制并修改 actions/app.go，非 Go 模块管理；第三方库须用 go get 手动导入并在 action 中显式调用。
buffalo plugins install 只对极少数官方插件有效
Buffalo 的 buffalo plugins install 命令不是通用依赖安装机制，它只适用于 github.com/gobuffalo/buffalo-pop 这类极少数由 Buffalo 官方维护、且明确设计为“插件”的组件。它的本质是把代码复制进项目并修改 actions/app.go，不是 Go 模块管理行为。
你搜到的 buffalo-i18n、buffalo-middleware-jwt 等包，最后更新都在 2022 年前，已归档失效；执行 go get github.com/gobuffalo/mw-i18n 会报 unknown revision v0.0.0-00010101000000-000000000000 —— 因为模块早已从仓库移除，go.mod 无法解析。
- 真正可用的第三方库（如
github.com/xuri/excelize/v2、golang.org/x/oauth2、github.com/google/uuid）全部走标准go get -
buffalo plugins install对sqlite3、excelize、redis等任何非官方插件都无效，强行运行只会报错或静默失败 - 若看到文档写“运行 buffalo plugins install xxx”，基本可判定该文档已过期（≥2023 年）
扩展功能必须直接 import + 手动集成
Buffalo 框架本身不提供插件注册点或钩子系统。所谓“扩展”，实际是绕过框架胶水层，在 actions/app.go 或具体 action 文件中手动调用第三方库逻辑。
例如加 OAuth2 登录：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go get golang.org/x/oauth2和对应 provider 包（如golang.org/x/oauth2/google） - 在
actions/auth.go中 import 并初始化oauth2.Config，不要试图塞进app.Use() - 定义
AuthCallbackaction，用r.Param("code")换 token，再查用户——整个流程不依赖任何 Buffalo 中间件封装 - 模板里用
<a href="<code>authURL"> 跳转，而不是期待某个buffalo-oauth2.LoginButton()函数
所有“插件式”能力（文件导出、短信发送、支付回调）都按此模式：import → 初始化 → 在 action 里显式调用 → 返回 JSON 或重定向。
中间件扩展要符合 buffalo.MiddlewareFunc 签名
如果你确实需要挂载中间件（比如日志增强、请求 ID 注入），必须严格满足 buffalo.MiddlewareFunc 类型：func(next buffalo.Handler) buffalo.Handler。这不是 HTTP 中间件，不能直接传 http.HandlerFunc。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
常见错误：
- 把
func(w http.ResponseWriter, r *http.Request)直接传给app.Use()→ 编译失败：类型不匹配 - 在中间件里调用
w.WriteHeader()或写 body 后还调next(c)→ 后续 handler panic：http: multiple response.WriteHeader calls - 忘记在中间件内部提取
c.Request()或c.Response()，导致无法读取 header 或写 cookie
正确写法示例：
func MyLogger(next buffalo.Handler) buffalo.Handler {
return func(c buffalo.Context) error {
start := time.Now()
err := next(c)
c.Log().Infof("req=%s %s %v", c.Request().Method, c.Request().URL.Path, time.Since(start))
return err
}
}
然后在 actions/app.go 中 app.Use(MyLogger) —— 注意，这个函数必须放在 app.Use() 调用链里，不能放在 app.GET() 里。
模板函数扩展只能注册到 Plush，且仅限 .html.plush
Buffalo 的模板引擎是 Plush，扩展模板函数必须通过 plush.Helper 注册，且只对 .plush.html 或 .html（默认启用 Plush）生效；.gohtml 或纯 .html 不识别。
关键限制：
- 注册入口在
actions/app.go的app = buffalo.New(...)之后、app.Serve()之前 - 必须用
app.Renderer.AddHelper("myfunc", func(...){...})，不能改全局 plush.FuncMap - 函数参数和返回值必须是 Go 原生类型（
string、int、map[string]interface{}），不支持context.Context或buffalo.Context - 模板中调用时无自动 context 传递，所有依赖（如当前语言、用户信息）需显式传参：
{{ myfunc .User.Email }}
一旦你用了 buffalo new --api，templates/ 目录默认被删，此时注册 helper 完全无意义——因为根本没模板可渲染。
真正容易被忽略的是：Buffalo 的“插件系统”在 2022 年归档后已停止演进，所有扩展行为本质上都是对 Go 原生生态的直接调用。你写的每个 go get、每个 import、每个 app.Use()，都不是在用 Buffalo 插件，而是在用 Go 生态本身。框架只提供了路由分发和 Context 封装这一层薄胶水，其余全是自己扛。
