buffalo cli 安装失败主因是 go 版本低于 1.23 或 goproxy 未设置，需确认 go version ≥1.23、配置 goproxy、在空目录执行 go install，并手动将 $gopath/bin 加入 path。
Buffalo CLI 安装失败，90% 是 Go 版本不匹配或 PATH 没配对，不是网络或权限问题。
go install 失败提示 “cannot find module providing package”
这是最典型的错误，根本原因只有两个：Go 版本低于 1.23，或 GOPROXY 未设置导致无法拉取 GitHub 仓库。
- 先运行
go version，输出必须是go version go1.23.x或go version go1.24.x；1.22 及更早版本会直接编译失败 - 若版本正确但依然报错，执行：
go env -w GOPROXY=https://proxy.golang.org,direct（国内用户建议换为https://goproxy.cn） - 不要在项目目录里执行
go install——它不依赖go.mod，必须在任意空目录下运行
buffalo version 报 command not found
说明二进制文件已生成，但 shell 找不到它。Buffalo 不会自动修改 PATH，这一步必须手动完成。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 运行
go env GOPATH，记下输出路径（如/home/user/go） - 确认
$GOPATH/bin是否已在 PATH 中：echo $PATH | grep "$GOPATH/bin"，无输出就要补 - Linux/macOS：在
~/.bashrc或~/.zshrc加一行export PATH="$GOPATH/bin:$PATH"，然后source它 - Windows（Git Bash）：用
export PATH="/c/Users/xxx/go/bin:$PATH"，别用 Windows 原生 CMD
Windows 下用 Scoop 安装却提示找不到 buffalo
Scoop 安装本身没问题，但常见于终端环境不干净：Git Bash 启用了 GOPATH 模式，或 Scoop 被装在非标准路径。
- 先运行
scoop which buffalo，看是否返回路径；没返回说明没装成功，重试scoop install buffalo - 如果返回路径但
buffalo version仍报错，检查是否在 PowerShell 或 CMD 里执行了 Scoop 命令——Scoop 只保证在它自己的 shell（如 Scoop Terminal）中生效 - 彻底避免 GOPATH 干扰：运行
go env -u GOPATH，强制启用 modules 模式
安装后 buffalo dev 启动报错 “failed to build binary”
这不是 CLI 安装问题，而是 Buffalo 项目构建依赖缺失，常发生在启用了 SQLite 或需要 cgo 的场景。
- Linux/macOS：确保系统已安装
gcc或clang，否则sqlite3驱动编译失败 - macOS M-series：若报
ld: library not found for -lsqlite3，运行brew install sqlite3并确认pkg-config --modversion sqlite3可查到版本 - Windows：用 Scoop 安装时自动带
mingw-w64，但若用go install方式，需额外安装 TDM-GCC 并加入 PATH
真正卡住的点往往藏在 go env GOPATH 和 $PATH 的衔接上——哪怕只差一个 /bin 后缀，buffalo 就永远是个“不存在的命令”。
