必须先安装buffalo CLI，否则buffalo new、buffalo dev等命令均报command not found；需Go 1.21+，用go install github.com/gobuffalo/cli/cmd/buffalo@latest安装，并确保$GOPATH/bin已加入PATH。
必须先装 buffalo CLI，否则所有后续命令（如 buffalo new、buffalo dev）都会报 command not found。
确认 Go 环境是否达标
Buffalo CLI 是用 Go 写的，依赖 Go 的构建系统。执行 go version，输出必须是 go1.21 或更高版本——低于这个版本，go install 会失败或编译出错。如果没装 Go，去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 go1.26.0（当前最稳兼容版）。装完后运行 go env GOPATH，确保返回一个非空路径；这是 go install 默认放二进制的位置，后续要加进 PATH。
用 go install 安装最新 CLI
在终端中直接运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
这条命令会拉源码、编译、安装到 $GOPATH/bin/buffalo。不需要进任何项目目录，也不需要 go.mod。常见报错 cannot find module providing package，基本就是 Go 版本太低，或者 GitHub 访问不通（可临时配 GOPROXY=https://goproxy.cn 试试）。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
验证并修复 PATH 缺失问题
关掉当前终端，新开一个，运行：
buffalo version
看到类似 v0.18.13 就成功了。如果还是 command not found，八成是 $GOPATH/bin 没进 PATH。Linux/macOS 用户可在 ~/.bashrc 或 ~/.zshrc 里加一行：export PATH=$PATH:$GOPATH/bin，然后 source 一下。Windows 用户请检查系统环境变量是否包含该路径。
没有 Go 环境时的备用方案
不想装 Go？直接下预编译包：
- Linux/macOS：去
https://github.com/gobuffalo/cli/releases下最新buffalo_*.tar.gz（比如buffalo_0.18.13_linux_amd64.tar.gz），解压后把buffalo二进制扔进/usr/local/bin/，再chmod +x /usr/local/bin/buffalo； - Windows：用 Scoop 更省事——先
scoop bucket add extras，再scoop install buffalo，PATH 自动搞定。
PATH 配置这一步最容易被跳过，也是新手卡住最多的地方；CLI 本身不会自动注册到 shell 路径里，不手动加就永远找不到命令。
