必须先安装buffalo cli，否则所有buffalo命令（如new、dev、db migrate）均报command not found；需go 1.21+，通过go install github.com/gobuffalo/cli/cmd/buffalo@latest安装，或下载预编译包并配置path，最后用buffalo version验证。
必须先装 CLI，否则所有 buffalo 命令都报 command not found。 Buffalo 是个重度依赖命令行的框架，buffalo new、buffalo dev、buffalo db migrate 全部需要 buffalo 这个二进制可执行文件在 PATH 里。没它，项目根本跑不起来。
确认 Go 环境是否达标
Buffalo CLI 是用 Go 写的，不是脚本，对 Go 版本有硬性要求：
-
go version必须输出go1.21或更高——低于这个版本，go install会失败或编译出错 -
go env GOPATH必须返回一个真实路径（比如/home/you/go），这是go install默认放二进制的位置 - 如果没装 Go，去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下
go1.26.0（当前最稳兼容版），装完别忘了配PATH
用 go install 安装 buffalo CLI
这是最推荐的方式，干净、可控、自动更新：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 终端里直接运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest - 它会拉源码、编译、把
buffalo二进制丢进$GOPATH/bin/buffalo - ⚠️ 如果提示
cannot find module providing package，八成是 Go 版本太低，或者 GitHub 访问不了——这时改用预编译包（见下一节） - 装完必须新开一个终端窗口，再运行
buffalo version；如果还是command not found，说明$GOPATH/bin没进系统PATH，得手动加
没有 Go 环境？用预编译二进制包
Linux/macOS 用户可跳过 Go，直接拿编译好的二进制：
- 去 https://www.php.cn/link/021dc8a02db486be71b957e17dd996d6 下最新
buffalo_*.tar.gz（比如buffalo_0.18.13_linux_amd64.tar.gz） - 解压后把
buffalo文件复制到/usr/local/bin/（或你 PATH 里的任意目录） - 执行：
chmod +x /usr/local/bin/buffalo - Windows 用户更简单：用 Scoop，先
scoop bucket add extras，再scoop install buffalo，PATH 自动搞定
最容易被忽略的是 PATH 配置——哪怕 go install 成功了，$GOPATH/bin 不在 shell 的 PATH 里，buffalo 就永远找不到。别信“装完就能用”，一定要新开终端、亲自敲 buffalo version 验证。
