必须先安装Buffalo CLI工具，要求Go 1.21+，通过go install github.com/gobuffalo/cli/cmd/buffalo@latest安装或下载预编译包并配置PATH，再用buffalo version验证。
Buffalo CLI 工具没装好，后面所有命令（buffalo new、buffalo dev）都会报 command not found——这不是框架问题，是 PATH 或 Go 环境没到位。
确认 Go 环境是否达标
Buffalo CLI 是用 Go 写的，不是独立二进制。必须先有 Go 1.21+，否则 go install 会失败或编译出错。
- 运行
go version，输出必须类似go version go1.26.0 darwin/arm64 - 若版本低于 1.21，请去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 1.26.0 安装
- 运行
go env GOPATH，确保返回一个真实路径（如/Users/you/go），这是go install默认放二进制的地方
用 go install 安装 buffalo CLI
这一步不依赖任何项目目录，也不需要 go.mod，直接在任意终端执行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
安装成功后，二进制会落在 $GOPATH/bin/buffalo。常见卡点：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 提示
cannot find module providing package：大概率 Go 版本太低，或 GitHub 访问受限；可临时加代理：export GOPROXY=https://proxy.golang.org,direct - 执行完没反应？别急，它在后台编译，通常 10–30 秒完成
验证并修复 PATH 问题
关掉当前终端，新开一个，再跑：
buffalo version
如果输出类似 v0.18.13，就成功了。如果还是 command not found，说明 $GOPATH/bin 没进系统 PATH：
- macOS/Linux：检查
~/.zshrc或~/.bash_profile是否含export PATH="$GOPATH/bin:$PATH" - Windows（CMD/PowerShell）：确认系统环境变量中
Path包含%USERPROFILE%\go\bin - 别跳过这步——90% 的“安装失败”其实只是 PATH 没生效
没有 Go 环境？用预编译包替代
纯前端或 CI 环境不想装 Go？直接下编译好的二进制：
- Linux/macOS：去 GitHub Releases 下
buffalo_*.tar.gz，解压后把buffalo文件丢进/usr/local/bin/并chmod +x - Windows：用 Scoop 最省事：
scoop bucket add extras && scoop install buffalo，PATH 自动搞定
注意：预编译包不依赖 Go，但后续项目仍需 Go 编译运行——CLI 只是工具，不是运行时。
