Buffalo CLI安装后command not found主因是PATH未配置，需将$GOPATH/bin加入shell PATH；同时要求Go 1.21+（推荐1.26.0），并确保数据库服务运行及执行buffalo db migrate。
Buffalo CLI 不是“装完就能用”的工具，buffalo 命令在终端里直接报 command not found 是最常见、也最容易被误判为“安装失败”的问题——其实大概率是 PATH 没配对，而不是没装上。
go install 失败：检查 Go 版本和代理
执行 go install github.com/gobuffalo/cli/cmd/buffalo@latest 报错，第一反应不是重试，而是查根本条件：
-
go version必须输出go1.21或更高（2026 年推荐用go1.26.0）；低于 1.21 会触发模块解析失败，错误信息常含cannot find module providing package -
go env GOPROXY如果为空或指向不可达地址（比如直连 GitHub），在国内基本必失败；建议设为https://goproxy.cn,direct再重试 - 不需要提前
go mod init，go install是全局命令，不依赖当前目录是否有go.mod
buffalo command not found：PATH 是唯一关键
即使 go install 明明成功了，新开终端仍提示 command not found，90% 是因为 $GOPATH/bin 没进 shell 的 PATH。验证和修复步骤很直接：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 运行
go env GOPATH，记下输出路径（例如/home/you/go） - 确认
/home/you/go/bin/buffalo文件真实存在且有可执行权限（ls -l /home/you/go/bin/buffalo） - 把该路径加进 shell 配置文件：
echo 'export PATH=$PATH:/home/you/go/bin' >> ~/.zshrc（macOS / Linux）或echo 'set PATH=%PATH%;C:\Users\you\go\bin' >> %USERPROFILE%\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1（Windows PowerShell） - 然后
source ~/.zshrc或重启终端，再跑buffalo version
没装 Go 怎么办：用预编译二进制包
如果你只是想快速试 Buffalo，不想装 Go 环境，就跳过 go install，直接拿官方编译好的二进制：
- 去 GitHub releases 页面 下载对应系统的
buffalo_*.tar.gz（如buffalo_0.18.13_linux_amd64.tar.gz） - 解压后得到单个
buffalo可执行文件，把它挪到系统 PATH 目录里：sudo mv buffalo /usr/local/bin/（Linux/macOS）或丢进C:\Windows\System32（Windows） - Windows 用户更推荐用 Scoop：
scoop bucket add extras && scoop install buffalo，自动处理 PATH，不用手动 chmod 或移动文件
buffalo new 启动前必须做的三件事
别急着 buffalo dev，否则十有八九卡在数据库 panic 上：
- 先确保数据库服务已运行（PostgreSQL 默认端口 5432，MySQL 3306），且
database.yml里的user、password、database能连通 - 手动执行一次
buffalo db migrate，生成初始表结构；buffalo dev不会自动做这步 - 项目必须在空目录下创建：
buffalo new myapp会拒绝在已有go.mod或main.go的目录里初始化，报错退出而非覆盖
PATH 配置和数据库迁移这两步，一个影响命令能否敲出来，一个影响服务能否跑起来——它们不是“可选步骤”，而是 Buffalo 工作流里真正卡住人的两个硬性门槛。其他框架可能默认帮你兜底，Buffalo 不会。
