Buffalo CLI 不支持 buffalo --help 全局查看子命令,需用 buffalo help 列出顶层命令,再通过 buffalo help 或 --help 查具体用法;自定义插件命令参数需查源码或启用 verbose 模式验证。

buffalo 命令本身不提供全局 --help 或 -h 参数来列出所有子命令;必须对每个具体命令单独查帮助,否则看不到可用选项。
buffalo 命令怎么查 help 信息
Buffalo CLI 使用 cobra 构建,帮助文档只挂载在具体子命令下,buffalo --help 或 buffalo -h 会报错或无输出。正确方式是:
-
buffalo help:显示顶层命令列表(如dev、generate、db等) -
buffalo help:查看某命令的详细用法,例如buffalo help dev或buffalo help generate -
buffalo:等价于--help buffalo help,比如buffalo db migrate --help
常见命令参数容易被忽略的细节
很多参数名不直观,且部分仅在特定上下文生效,直接看 help 输出也容易漏掉关键约束:
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
buffalo dev --port和--host只在开发时有效,buffalo build不认这两个参数 -
buffalo db migrate --env指定的是 pop 的环境(对应database.yml中的 section),不是 Buffalo 的GO_ENV -
buffalo generate resource后跟的参数顺序固定:buffalo generate resource users name:string age:int,字段定义必须紧接资源名,中间不能换行或加 flag -
buffalo build --static会禁用 packr 打包,但不会自动复制public/下的文件——得确保构建前该目录已存在且内容完整
自定义插件命令的参数怎么查
如果你自己添加了 CLI 插件(比如在 buffalo/cmd/root.go 里注册的 migrate:reset),它的参数不会出现在 buffalo help 默认列表中,除非显式设置 Cmd.Hidden = false 并调用 Cmd.SetHelpFunc。实际使用时只能靠:
- 查源码里
Run函数签名和注释 - 运行
buffalo help—— 如果你没改 help 文本,它只会显示空或默认提示 - 在插件命令的
Run函数开头加fmt.Printf("%+v\n", args)临时观察传入参数
真正要确认一个参数是否生效,最可靠的方式是加 -v 或 --verbose(如果命令支持),或者直接看命令执行时的底层日志输出——很多参数只影响内部行为,不改变 help 文本。










