必须先安装Buffalo CLI，它是独立可执行工具而非库，需用go install github.com/gobuffalo/cli/cmd/buffalo@latest安装到$GOPATH/bin，并确保Go≥1.21且$GOPATH/bin已加入PATH，否则buffalo命令不可用。
必须先装 buffalo CLI，否则所有后续命令（如 buffalo new、buffalo dev）都会报 command not found。它不是库，而是独立可执行工具，不通过 go get 或 go mod 引入项目。
确认 Go 环境是否达标
Buffalo CLI 是用 Go 写的，依赖 Go 工具链。执行：
go version
输出必须是 go1.21 或更高——低于此版本会触发 go install 编译失败。若未安装或版本过低，请下载 go1.26.0（当前稳定兼容版）并配置好 PATH。
还要检查：
go env GOPATH
确保返回非空路径。这是 go install 默认把二进制放进去的地方，后续要把它加进系统 PATH。
用 go install 安装 buffalo CLI
在终端中直接运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
这条命令会拉源码、编译、安装到 $GOPATH/bin/buffalo。不需要进任何项目目录，也不需要 go.mod。
- 如果提示
cannot find module providing package，大概率是 Go 版本太低，或 GitHub 访问受限；此时应配置GOPROXY，或改用预编译包 - 安装过程不产生项目文件，只生成一个二进制，和
npm install -g类似
验证安装并修复 PATH 问题
关掉当前终端，新开一个，再运行：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
buffalo version
看到类似 v0.18.13 的输出，说明成功。如果还是 command not found，90% 是 $GOPATH/bin 没进 PATH。
手动加进去（以 bash 为例）：
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc && source ~/.bashrc
zsh 用户改 ~/.zshrc。这一步跳过，就永远找不到 buffalo。
没有 Go 环境时的替代方案
Linux/macOS 用户可直接下预编译包：
- 去 GitHub 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
Scoop 会自动注册 PATH，省去手动配置环节。
真正卡住人的从来不是安装命令本身，而是 $GOPATH/bin 没进 PATH，或者用了旧版 Go 却没意识到 @latest 已不再兼容。装完别急着建项目，先 buffalo version 看一眼输出——这是唯一可靠的验证动作。
