必须先正确配置 GOROOT、GOPATH 和 PATH，否则 go install 会失败或 buffalo 命令报 command not found；需 Go 1.21+，通过 go version 验证，再导出 GOPATH 和 $GOPATH/bin 到 PATH，最后用 go install github.com/gobuffalo/cli/cmd/buffalo@latest 安装并用 buffalo version 确认。
必须先配好 GOROOT、GOPATH 和 PATH，否则 go install 会失败或装到不可达路径，后续 buffalo 命令始终报 command not found。
确认 Go 已安装且版本达标
Buffalo CLI 要求 Go 1.21+，低于此版本 go install 可能直接报错 “unknown directive @latest”。执行：
go version
输出应类似 go version go1.26.0 linux/amd64。若未安装或版本过低，请去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统安装包。
设置 GOROOT、GOPATH 和 PATH
GOROOT 指向 Go 安装根目录（通常自动设好），GOPATH 是工作区，PATH 必须包含 $GOPATH/bin——这是 go install 放二进制的位置。
- Linux/macOS：在
~/.bashrc或~/.zshrc中追加：
export GOPATH=$HOME/go export PATH=$PATH:$GOPATH/bin
- Windows（PowerShell）：运行：
[Environment]::SetEnvironmentVariable("GOPATH", "$HOME\go", "User")
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\go\bin", "User")
然后重启终端，执行 go env GOPATH 确认输出非空，再执行 echo $PATH | grep bin（Linux/macOS）或 $env:PATH（Windows）确认 bin 路径已存在。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
用 go install 安装 buffalo CLI
确保终端中能执行 go 命令后，直接运行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
该命令不依赖当前目录是否有 go.mod，也不需要进入任何项目。安装成功后二进制文件落在 $GOPATH/bin/buffalo。
- 若提示
cannot find module providing package：大概率是 Go 版本太低，或网络无法访问 GitHub；此时改用预编译包更稳 - 若执行
buffalo version报command not found：说明$GOPATH/bin没进PATH，不是 Buffalo 没装上，而是 shell 找不到它
验证 PATH 是否生效
关闭当前终端，新开一个，执行：
which buffalo
应输出类似 /home/username/go/bin/buffalo 的路径。再运行：
buffalo version
看到 v0.18.13 或更高版本号，才算真正就位。别跳过这步——90% 的安装失败都卡在 PATH 配置漏掉或未刷新 shell 环境。
