需将 $gopath/bin 加入 path 环境变量，并确保 buffalo 二进制已正确安装；若 go install 失败，建议改用 github 预编译包。
buffalo command not found 怎么办
安装后执行 buffalo version 报错 command not found，核心原因只有一个：系统 PATH 没有包含 $GOPATH/bin。Buffalo CLI 不会自动写入环境变量，这步必须手动补上。
确认 $GOPATH/bin 是否在 PATH 里
先查 GOPATH 路径：go env GOPATH，输出类似 /home/you/go 或 /Users/you/go；再检查 PATH 是否含对应 bin 目录：
- Linux/macOS：运行
echo $PATH | grep -o "$GOPATH/bin"，无输出即缺失 - Windows（CMD）：运行
echo %PATH%，手动找是否有go\bin路径 - 若用 PowerShell，需查
$env:PATH并注意路径分隔符是分号
常见坑：Go 安装时勾选了“Add to PATH”，但只加了 Go 自身路径（如 C:\Program Files\Go\bin），没加 $GOPATH/bin——这两者完全不同。
把 $GOPATH/bin 加进 PATH 的实操步骤
根据你的 shell 类型操作（别直接复制整段，先确认自己用的是哪个）：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- zsh（macOS Catalina 及以后、多数新 Linux 发行版）：编辑
~/.zshrc，末尾加一行export PATH="$GOPATH/bin:$PATH" - bash：编辑
~/.bashrc或~/.bash_profile，同样加export PATH="$GOPATH/bin:$PATH" - Windows PowerShell：运行
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:GOPATH\bin", "User")（需重启终端）
改完后必须新开终端窗口再试 buffalo version，当前窗口的 PATH 不会自动刷新。
go install 失败导致根本没生成 buffalo 二进制
如果 go install github.com/gobuffalo/cli/cmd/buffalo@latest 执行时卡住或报错，比如：
-
cannot find module providing package：Go 版本低于 1.21，或 GOPROXY 未配置（国内用户建议设为https://goproxy.cn） - 超时或连接 GitHub 失败：直接放弃
go install，改用预编译包 - 提示
GOBIN is set, but …：说明你手动设置了GOBIN，go install会把二进制放那里，而不是$GOPATH/bin——此时要检查go env GOBIN并把那个路径加入 PATH
预编译包最稳：去 https://github.com/gobuffalo/cli/releases 下载 buffalo_*.tar.gz，解压后把 buffalo 文件扔进 /usr/local/bin（macOS/Linux）或 C:\Windows\System32（Windows），再 chmod +x（Linux/macOS）即可。
PATH 配置错一个字符、终端没重开、或者 go install 根本没成功——这三个点只要漏掉一个，buffalo 就永远找不到。别猜，挨个验证。
