必须先安装 Go 1.21+ 并配置好 GOPATH 和 PATH，再执行 go install github.com/gobuffalo/cli/cmd/buffalo@latest 安装 Buffalo CLI，否则因依赖缺失或路径未识别导致 command not found。
必须先装 Go 1.21+，再用 go install 装 Buffalo CLI，否则所有命令都会报 command not found。
确认 Go 版本和 GOPATH 是否就绪
Buffalo CLI 是 Go 写的，不是独立二进制包——它依赖本地 Go 环境编译安装。跳过这步直接跑 go install，大概率失败。
- 执行
go version，输出必须是go1.21或更高（如go1.26.0）；低于此版本会触发cannot find module providing package错误 - 执行
go env GOPATH，确保返回一个真实路径（如/home/you/go或~/go）；这是go install默认放buffalo二进制的位置 - 检查
$GOPATH/bin是否已加入系统PATH：运行echo $PATH看有没有该路径；没有就补上，比如在~/.zshrc里加export PATH=$PATH:$GOPATH/bin
用 go install 安装 buffalo CLI
这条命令不进项目目录、不读 go.mod，纯客户端安装，但要求系统有 C 编译器（gcc 或 clang），因为 SQLite 驱动要编译。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 终端执行：
go install github.com/gobuffalo/cli/cmd/buffalo@latest - 如果卡在
go build或提示sqlite3.h: no such file，说明缺 C 工具链：Linux 上装build-essential（Debian/Ubuntu）或gcc（CentOS/RHEL）；macOS 上装xcode-select --install - Windows 用户若用 Git Bash 或 WSL2，务必确认没手动设置
GOPATH环境变量——Buffalo 强制启用 Go modules，一旦掉进 GOPATH 模式，buffalo new和数据库命令全失效
验证安装并处理 command not found
安装完别急着建项目，先验证 CLI 是否真可用。很多人卡在这一步，以为装好了，其实只是二进制没进 PATH。
立即学习“go语言免费学习笔记（深入）”；
- 关掉当前终端，新开一个，执行
buffalo version；成功时输出类似v0.18.13 - 如果报
command not found，90% 是$GOPATH/bin没进PATH；检查echo $PATH，确认路径存在且拼写正确（注意大小写、斜杠方向） - 备用方案：去
https://github.com/gobuffalo/cli/releases下对应系统的buffalo_*.tar.gz，解压后把buffalo文件复制到/usr/local/bin/（Linux/macOS）或%USERPROFILE%\scoop\shims\（Windows + Scoop），再chmod +x或刷新 Scoop
最常被忽略的点：Buffalo CLI 不是“装完就自动可用”，它的二进制位置完全由 go install 的 GOPATH 决定，而这个路径不会被 shell 自动识别——你得亲手把它塞进 PATH，少一个字符都白装。
