Buffalo 的 help 命令仅显示已注册子命令及短描述，不解释参数、环境依赖、失败路径或项目级动态约束；真实行为需查源码，且所有命令必须在含 buffalo.yaml 的项目根目录下执行。

Buffalo 的 help 命令不是万能说明书，它只显示已注册的 Cobra 子命令及其短描述，不解释参数含义、不展示环境依赖、也不提示常见失败路径——直接看 buffalo help 容易漏掉关键约束。

buffalo help 不会告诉你哪些命令根本不能单独运行

比如 buffalo db 显示子命令列表，但 buffalo db migrate 实际执行前必须满足三个硬条件：数据库服务已启动、config/database.yml 中 development 区块配置有效、且 models/pop.go 已初始化 Pop 连接。这些在 buffalo help db migrate 里完全不提。

• buffalo dev 的帮助页不会警告你：它默认监听 actions/ 和 templates/ 变更，但改了 main.go 或 go.mod 不会触发重启
• buffalo g resource 的帮助说明“生成资源”，但没写清：它强制要求模型字段用 string 类型 + db:"xxx" tag，否则后续 buffalo db migrate 会静默跳过该字段
• buffalo task 列出所有已注册任务，但不校验 tasks/*.go 文件是否真正被 tasks/tasks.go 导入 —— 漏掉 import _ "myapp/tasks" 就等于没注册

buffalo help 输出的命令未必在当前项目中可用

帮助信息来自 Cobra 根命令的注册链，而 Buffalo 的命令集是「项目级动态组装」的。例如：

Buffalo框架 1.0.1

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

下载

• 刚 buffalo new myapp --api 创建的项目，buffalo help 仍会显示 assets:build 和 webpack:dev-server，但这些命令实际调用 npm，若你删了 assets/ 目录又没装 Node.js，运行时直接 panic
• 自定义命令（如 migrate:reset）只有在 buffalo/cmd/root.go 中显式 rootCmd.AddCommand(...) 后才会出现在 buffalo help 里；手写一个 cmd/reset.go 但没注入，help 就看不到
• buffalo plugins 命令虽在 help 列表中，但 Buffalo 1.0+ 已彻底移除插件系统，执行必报 command not found

想查某个命令的真实行为，别只信 help，要看源码入口

Buffalo CLI 是基于 spf13/cobra 构建的，每个子命令最终都指向一个 Run 函数。例如想知道 buffalo db create 到底做了什么：

• 它实际调用的是 pop/soda 的 CreateDatabase，逻辑在 github.com/gobuffalo/pop/v6/soda/cmd/create.go
• 该函数会读取 database.yml，但**只读 development 区块**，且忽略 host 字段中的 localhost（自动转为 127.0.0.1），这导致 PostgreSQL 配置 host: localhost 时连接失败
• buffalo help db create 完全不提这个转换逻辑，只能翻源码或看错误日志里的 dial tcp 127.0.0.1:5432

真正容易被忽略的，是 Buffalo 所有命令的上下文都绑定在项目根目录下——buffalo help 不会提醒你：离开包含 buffalo.yaml 的目录再执行任何命令，都会报 no app found，而不是显示帮助。