Buffalo 的 Plush 模板不支持跨包注册全局帮助函数，仅自动扫描 actions/ 目录下签名匹配 func(buffalo.Context) interface{} 的函数并注册；外部包函数需通过符号链接或同包封装调用，init 或 Configure 阶段注册无效。

Buffalo 的 Plush 模板不支持跨包注册全局帮助函数——它只认 actions 和 templates 目录下、由 Buffalo 自动加载的函数，且必须在当前项目包内定义。

Plush 的 help 函数必须定义在 main 包或 actions 包里

Plush 在启动时通过反射扫描 actions 目录下的所有 .go 文件，查找签名匹配 func(buffalo.Context) interface{} 的函数，并自动注册为模板 helper。它不会 import 或 resolve外部包路径，也不执行 go mod 级别的包引用解析。

• 如果你把 helper 定义在 helpers/utils.go（非 actions/ 下），buffalo dev 启动时完全看不到它
• 即使你在 actions/app.go 里 import "myapp/helpers" 并手动调用 plush.Helper("myfunc", helpers.MyFunc)，也无效：Buffalo 的 Plush 实例是私有封装的，不暴露底层 plush.Context 注册接口
• 试图用 plush.New() 新建一个上下文并传给模板？不行——Buffalo 的 c.Render() 内部强制使用自己的 plush.Context 实例，你传进去的会被丢弃

唯一可行的“伪跨包”做法：符号链接 + 同包声明

想复用逻辑但又得让 Plush 看见，只能绕过“包隔离”，把函数体物理放在 Buffalo 认可的位置，再通过 Go 的导出规则复用实现。

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• 把实际逻辑写在 pkg/helpers/string.go，例如：func FormatPrice(v float64) string { ... }
• 在 actions/helpers.go（必须在 actions/ 目录下）中声明同名导出函数：

  package actions
  
  import "myapp/pkg/helpers"
  
  func FormatPrice(c buffalo.Context) interface{} {
      // 注意：c 参数在这里通常不用，只是满足 Plush 签名要求
      return helpers.FormatPrice(0) // 占位，真实参数从模板传入
  }

• 模板里仍写 ——Plush 调用的是 actions.FormatPrice，但它内部转调了 pkg/helpers 的实现

为什么不能用 init() 或 buffalo.App.Configure() 注册？

因为 Buffalo 在 App.BuildTemplates() 阶段（即 buffalo dev 启动早期）就冻结了 Plush helper 表，之后任何对 plush.Helper 的调用都无效。常见错误包括：

• 在 config/buffalo_app.go 的 App.Configure() 里调用 plush.Helper("foo", ...) → 无效果，helper 表已构建完毕
• 在 models/ 里写 func init() { plush.Helper(...) } → 编译失败，plush 包未被该包 import，且 models 不参与模板初始化流程
• 用 buffalo generate resource 创建的 action 文件里注册 → 只对该 resource 模板生效，不是全局

真正跨包共享模板逻辑的合理路径，是放弃 Plush helper，改用 partial 模板 + 数据预处理：把格式化逻辑移到 handler 里，把结果作为 c.Set("formatted_price", ...) 传入模板。Plush 本身的设计边界就是单体应用模板层，强行跨包只会撞上它的加载机制硬限制。