buffalo cli必须通过go install或预编译包安装，用buffalo version验证；若报command not found，90%因$gopath/bin未加入path，需检查go version≥1.21、go env gopath路径有效并手动配置path。

Buffalo CLI 必须通过 go install 或预编译二进制安装，buffalo version 能直接验证是否就位；若报 command not found，90% 是 $GOPATH/bin 没进 PATH。

确认 Go 环境是否达标

Buffalo CLI 是 Go 写的命令行工具，不兼容低版本 Go：

• 运行 go version，输出必须是 go1.21 或更高（如 go1.26.0）；低于此版本，go install 会失败或生成不可用二进制
• 执行 go env GOPATH，确保返回一个真实路径（如 /home/you/go），这是 go install 默认写入 buffalo 的位置
• 若未装 Go，请去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 1.26.0 安装包，并配置好 GOROOT 和 PATH

用 go install 安装 buffalo CLI

这是最通用、推荐的方式，无需额外依赖：

Buffalo框架 1.0.1

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

下载

• 在终端中运行：go install github.com/gobuffalo/cli/cmd/buffalo@latest
• 该命令会拉取源码、编译、把 buffalo 二进制写入 $GOPATH/bin/buffalo
• ⚠️ 若提示 cannot find module providing package，大概率是 Go 版本太低，或网络无法访问 GitHub；此时改用预编译包更稳
• 安装后**必须新开终端窗口**——旧终端不会自动加载更新后的 PATH

验证安装与排查 command not found

别跳过这步，它是新手卡住最多的地方：

• 新开终端，运行：buffalo version；成功时输出类似 v0.18.13
• 若提示 command not found，检查 $GOPATH/bin 是否在 PATH 中：echo $PATH | grep "$(go env GOPATH)/bin"（Linux/macOS）或 echo %PATH%（Windows）
• 若没命中，手动追加：export PATH="$(go env GOPATH)/bin:$PATH"（加到 ~/.zshrc 或 ~/.bash_profile 并 source）
• Windows 用户用 Scoop 安装可跳过 PATH 手动配置：scoop bucket add extras && scoop install buffalo

真正容易被忽略的是：Buffalo CLI 不是“装完就自动可用”，它完全依赖 shell 的 PATH 查找机制；哪怕 go install 成功了，只要 $GOPATH/bin 不在当前 shell 的 PATH 里，buffalo 就永远是 command not found。