必须先安装buffalo CLI工具，否则buffalo new、buffalo dev等命令均报“command not found”；需确保Go≥1.21（推荐1.26.0），执行go install github.com/gobuffalo/cli/cmd/buffalo@latest，并将$GOPATH/bin加入PATH，最后用buffalo version验证。
必须先安装 buffalo CLI 工具，否则所有后续命令（如 buffalo new、buffalo dev）都会报 command not found。
确认 Go 环境是否满足最低要求
Buffalo CLI 是用 Go 写的，依赖 Go 的构建系统。执行 go version，输出必须是 go1.21 或更高版本；低于此版本会触发 go install 编译失败。若未安装，请从 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 Go 1.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 访问受限；此时应改用预编译包，或先配置代理：go env -w GOPROXY=https://goproxy.cn - 安装完成后，务必新开一个终端窗口再验证，避免 shell 缓存旧的
PATH
验证安装并处理常见失败
运行：
buffalo version
若输出类似 v0.18.13 的版本号，说明成功。若仍报 command not found，检查以下三点：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
$GOPATH/bin是否已加入系统PATH（Linux/macOS 查echo $PATH，Windows 查系统环境变量） - 是否在新终端中执行（旧终端不会自动加载更新后的
PATH） - 是否误将
buffalo二进制放到了非PATH目录（比如当前目录），却没加./buffalo前缀
没有 Go 环境时的替代方案
Linux/macOS 用户可下载预编译包：
- 访问 https://www.php.cn/link/021dc8a02db486be71b957e17dd996d6，找最新
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<br>scoop install buffalo
Scoop 会自动注册 PATH，省去手动配置步骤。
最容易被忽略的是：即使下载了预编译包，也必须确保其所在目录在 PATH 中；而用 go install 安装后，不重启终端或不重载 shell 配置，buffalo 命令依然不可见。
