必须先安装buffalo CLI工具，要求Go 1.21+，通过go install github.com/gobuffalo/cli/cmd/buffalo@latest安装或下载预编译包并配置PATH，最后用buffalo version验证。

必须先装 buffalo CLI，否则所有 Buffalo 命令（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 安装最新版

在终端执行：

go install github.com/gobuffalo/cli/cmd/buffalo@latest

它会拉源码、编译、放进 $GOPATH/bin/buffalo。不需要进项目目录，也不需要 go.mod。

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• 如果报 cannot find module providing package：八成是 Go 版本太低，或 GitHub 访问不通；此时改用预编译包（见下一条）或配 GOPROXY
• 安装完别急着验证——先关掉当前终端，新开一个，否则 $PATH 没刷新，buffalo 还是找不到

验证失败时最该查什么

运行 buffalo version，期望看到类似 v0.18.13 的输出。如果还是 command not found，90% 是 $GOPATH/bin 没进系统 PATH。

• Linux/macOS：检查 echo $PATH 是否含 $GOPATH/bin；没的话，在 ~/.bashrc 或 ~/.zshrc 里加一行 export PATH=$PATH:$GOPATH/bin，再 source 一下
• Windows（非 Scoop）：手动把 %USERPROFILE%\go\bin 加进系统环境变量 PATH
• 用 Scoop（推荐 Windows 用户）：先 scoop bucket add extras，再 scoop install buffalo，PATH 自动搞定

真正卡住人的从来不是安装命令本身，而是 $GOPATH/bin 路径没被 shell 识别——这个环节没有自动提示，得自己盯终端输出和环境变量。