Buffalo CLI必须通过go install或预编译包安装，用buffalo version验证；若报command not found，90%因$GOPATH/bin未加入PATH，需检查go version≥1.21、go env GOPATH路径有效并手动配置PATH。
Buffalo CLI 必须通过 go install 或预编译二进制安装，buffalo version 能直接验证是否就位；若报 command not found，90% 是 $GOPATH/bin 没进 PATH。
确认 Go 环境是否达标
Buffalo CLI 是 Go 写的命令行工具，不兼容低版本 Go：
- 运行
go version，输出必须是go1.21或更高（如go1.26.0）；低于此版本，go install会失败或生成不可用二进制 - 执行
go env GOPATH，确保返回一个真实路径（如/home/you/go），这是go install默认写入buffalo的位置 - 若未装 Go，请去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 1.26.0 安装包，并配置好
GOROOT和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；此时改用预编译包更稳 - 安装后**必须新开终端窗口**——旧终端不会自动加载更新后的
PATH
验证安装与排查 command not found
别跳过这步，它是新手卡住最多的地方：
- 新开终端，运行：
buffalo version；成功时输出类似v0.18.13 - 若提示
command not found，检查$GOPATH/bin是否在PATH中：echo $PATH | grep "$(go env GOPATH)/bin"（Linux/macOS）或echo %PATH%（Windows） - 若没命中，手动追加：
export PATH="$(go env GOPATH)/bin:$PATH"（加到~/.zshrc或~/.bash_profile并source） - Windows 用户用 Scoop 安装可跳过 PATH 手动配置：
scoop bucket add extras && scoop install buffalo
真正容易被忽略的是：Buffalo CLI 不是“装完就自动可用”，它完全依赖 shell 的 PATH 查找机制；哪怕 go install 成功了，只要 $GOPATH/bin 不在当前 shell 的 PATH 里，buffalo 就永远是 command not found。
