必须先安装buffalo CLI工具，否则buffalo new、buffalo dev等命令均报command not found；需确保Go≥1.21、GOPATH非空且$GOPATH/bin已加入PATH，再执行go install github.com/gobuffalo/cli/cmd/buffalo@latest，最后用buffalo version验证。
必须先安装 buffalo CLI 工具，否则所有项目命令（如 buffalo new、buffalo dev）都会报 command not found。
确认 Go 环境是否满足最低要求
Buffalo CLI 是用 Go 编写的，依赖 Go 的模块系统和构建工具。不满足版本要求会导致 go install 失败或二进制运行异常。
- 执行
go version，输出必须为go1.21或更高；低于此版本会触发cannot find module providing package错误 - 运行
go env GOPATH，确保返回非空路径（如/home/you/go），这是go install默认存放二进制的位置 - 检查
$GOPATH/bin是否已加入系统PATH：在新终端中执行echo $PATH，确认含该路径；Windows 用户需检查系统环境变量中是否包含%GOPATH%\bin
用 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 - 该命令会拉取源码、编译并安装到
$GOPATH/bin/buffalo，不依赖当前目录是否存在go.mod - 若提示
cannot find module providing package，大概率是 Go 版本过低或网络无法访问 GitHub；此时应升级 Go 或配置代理：go env -w GOPROXY=https://proxy.golang.org,direct
验证安装并处理常见失败
安装后必须新开终端窗口验证，因为 shell 不会自动重载 PATH。
- 执行
buffalo version，正常输出类似v0.18.13即成功 - 若仍提示
command not found，请检查：ls -l $GOPATH/bin/buffalo是否存在且有可执行权限；若无，说明go install未写入该路径 - Linux/macOS 用户可手动软链：
sudo ln -s $GOPATH/bin/buffalo /usr/local/bin/buffalo（需确认/usr/local/bin在PATH中） - Windows 用户若用 Scoop，可跳过上述步骤：
scoop bucket add extras && scoop install buffalo，Scoop 会自动注册 PATH
真正卡住人的从来不是安装命令本身，而是 $GOPATH/bin 没进 PATH，或者用了旧版 Go 却没意识到错误信息的真实含义——这两点占新手安装失败的 90% 以上。
