必须先安装 Go 1.21+，再用 go install 安装 Buffalo CLI，最后新开终端执行 buffalo version 验证；缺任一环会导致 command not found 或编译失败，且 PATH 必须包含 $GOPATH/bin。
必须先装好 Go 1.21+，再用 go install 装 Buffalo CLI，最后验证 buffalo version 输出版本号——缺任何一环都会卡在 “command not found” 或编译失败。
确认 Go 环境是否达标
Buffalo CLI 是 Go 写的二进制工具，不是脚本，它依赖 Go 的构建链。低于 Go 1.21 会触发 go install 编译失败，尤其常见于 macOS 自带的旧版 Go 或通过包管理器误装的 Go 1.19。
- 运行
go version，输出必须类似go version go1.26.0 darwin/arm64 - 运行
go env GOPATH，确保返回非空路径（如/Users/you/go），这是go install默认放二进制的位置 - 若未安装 Go，请直接下载 Go 1.26.0 安装包（非 Homebrew 或 apt 源），安装后重启终端再验证
用 go install 安装 buffalo CLI
这是最稳定、最轻量的方式，不依赖项目目录，也不改系统 PATH（但你要确保 $GOPATH/bin 已在 PATH 中）。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 执行命令：
go install github.com/gobuffalo/cli/cmd/buffalo@latest - 如果报错
cannot find module providing package，大概率是 Go 版本太低或 GitHub 访问受限；此时别硬试，换预编译包 - 安装成功后，
$GOPATH/bin/buffalo就是可执行文件，不用手动复制
验证安装并处理 PATH 问题
新手卡住的 80% 都在这里：CLI 装好了，但 shell 找不到命令。因为 go install 不会自动把 $GOPATH/bin 加进 PATH，你得自己配。
- 新开一个终端（不要复用当前窗口），执行
buffalo version - 若提示
command not found，检查echo $PATH是否包含$GOPATH/bin；没包含就加，例如在~/.zshrc末尾加一行：export PATH="$GOPATH/bin:$PATH"，然后source ~/.zshrc - Windows 用户若用 Scoop，直接
scoop install buffalo更省事，Scoop 自动注册 PATH
备用方案：下载预编译二进制
没有 Go 环境，或者公司网络屏蔽 GitHub，就跳过 go install，直取二进制。
- 去
https://github.com/gobuffalo/cli/releases下最新 release，选对应系统的buffalo_*.tar.gz（如buffalo_0.18.13_linux_amd64.tar.gz） - 解压后得到
buffalo文件，把它放进/usr/local/bin/（Linux/macOS）或C:\Windows\（Windows），并运行chmod +x /usr/local/bin/buffalo - Windows 命令行中验证：
buffalo version；若报“不是内部或外部命令”，说明没放对位置或没加进 PATH
真正容易被忽略的是：安装完必须新开终端验证，而不是在当前窗口重试。PATH 变更不会自动广播给已有 shell 进程，强行 source 也不一定生效——关掉重开最可靠。
