Buffalo CLI 必须通过 go install 安装且 Go 版本严格限定为 1.23 或 1.24，执行 go install github.com/gobuffalo/cli/cmd/buffalo@latest 后需手动将 $GOPATH/bin 加入 PATH，再用 buffalo version 验证；若失败则改用预编译二进制包。
Buffalo CLI 必须通过 go install 安装，且 Go 版本必须为 1.23 或 1.24；低于或高于这个范围都会导致编译失败、命令不可用或运行时 panic。
确认 Go 环境是否达标
Buffalo 不兼容 Go 1.22 及更早版本，也不支持 1.25+。执行 go version，输出必须形如 go version go1.23.7 或 go version go1.24.3。若不匹配，需卸载旧版并安装 Go 1.24（当前最稳）。同时运行 go env GOPATH，确保有非空路径返回——这是 go install 默认放置二进制的位置。
执行 go install 安装 buffalo CLI
在终端中直接运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
该命令会拉取源码、编译并把 buffalo 二进制写入 $GOPATH/bin/buffalo。注意：
• 若提示 cannot find module providing package，大概率是 Go 版本过低或网络无法访问 GitHub，此时应改用预编译包；
• 不需要先进入某个项目目录，也不依赖 go.mod；
• 安装过程不自动将 $GOPATH/bin 加入 PATH，这一步必须手动完成。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
验证安装并修复 PATH 缺失
关掉当前终端，新开一个窗口，执行：
buffalo version
若输出类似 v0.18.13 的版本号，说明成功；若报 command not found，说明 $GOPATH/bin 未加入系统 PATH。按以下方式修复：
• macOS/Linux：在 ~/.zshrc 或 ~/.bash_profile 中追加 export PATH="$GOPATH/bin:$PATH"，再执行 source ~/.zshrc；
• Windows（PowerShell）：运行 $env:PATH += ";$env:GOPATH\bin"，并把它加到你的 $PROFILE 中。
备用方案：跳过 Go 直接用预编译二进制
适用于没有 Go 环境、或企业内网禁用 go install 的场景：
• 访问 GitHub Releases 页面，下载对应系统的 buffalo_*.tar.gz（如 buffalo_0.18.13_linux_amd64.tar.gz）；
• 解压后把 buffalo 文件复制到 /usr/local/bin/（Linux/macOS）或 C:\Windows\（Windows），并确保有执行权限（Linux/macOS 执行 chmod +x /usr/local/bin/buffalo）；
• Windows 用户推荐用 Scoop：scoop bucket add extras && scoop install buffalo，它会自动处理 PATH 注册。
最容易被忽略的点是：哪怕你用 go install 成功了，只要没重启终端或没更新 PATH，buffalo 命令就永远找不到——这不是安装失败，而是 shell 路径没生效。每次卡在 command not found，第一反应不该是重装，而是查 echo $PATH 里有没有 $GOPATH/bin。
