必须用 go install 且 go ≥1.21，命令为 go install github.com/gobuffalo/cli/cmd/buffalo@latest；安装后需将 $gopath/bin 加入 path；网络不佳时建议直接下载预编译包；cli 安装后须手动执行 buffalo db migrate。

必须用 go install，且 Go 版本不能低于 1.21 —— 低于这个版本会编译失败或拉不到依赖。

go install 命令要写对路径和版本后缀

Buffalo CLI 的模块路径是 github.com/gobuffalo/cli/cmd/buffalo，不是旧版的 github.com/gobuffalo/buffalo。从 v0.18 开始，CLI 已拆分为独立仓库，写错路径会报 cannot find module providing package。

• 正确命令：go install github.com/gobuffalo/cli/cmd/buffalo@latest
• 若需指定版本（比如修复某个 panic），可换为：go install github.com/gobuffalo/cli/cmd/buffalo@v0.18.13
• 不加 @latest 或 @vX.X.X 会导致 go 按当前目录 go.mod 解析，大概率失败

安装后二进制默认放在 $GOPATH/bin，PATH 必须包含它

执行完 go install 后，buffalo 可执行文件不会自动加入系统 PATH。新开终端运行 buffalo version 报 command not found 是最常见卡点。

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

• 先确认 GOPATH：go env GOPATH，输出应为类似 /home/you/go 或 /Users/you/go
• 检查 $GOPATH/bin 是否已在 PATH 中：echo $PATH | grep -o "$GOPATH/bin"
• 没命中？临时补上：export PATH="$GOPATH/bin:$PATH"；永久生效需写入 ~/.zshrc 或 ~/.bashrc

网络不通时别硬等，改用预编译包更稳

如果 go install 卡在 “Fetching” 或报 “timeout”，说明 GitHub 访问不稳定 —— 这比版本错误更常发生，尤其在国内环境。

• 去 https://github.com/gobuffalo/cli/releases 下载对应系统的 buffalo_*.tar.gz（如 buffalo_0.18.13_linux_amd64.tar.gz）
• 解压后把 buffalo 文件复制到 /usr/local/bin/ 或任意 PATH 目录，再 chmod +x /usr/local/bin/buffalo
• 这种方案完全绕过 Go 构建链，也不依赖 gcc，适合 CI 或无 Go 环境的部署机

真正容易被忽略的是：即使你只打算用 Buffalo 生成项目，也必须先装 CLI；而装 CLI 之后，buffalo dev 启动前还必须手动跑 buffalo db migrate，否则第一次访问页面就 panic —— 它不会帮你自动做数据库迁移。