Buffalo命令找不到的三大原因：PATH未配置、二进制未安装、终端未重启；需检查$GOPATH/bin是否在PATH中，确认buffalo二进制存在并正确安装，且修改配置后必须新开终端生效。
buffalo 命令找不到，核心就三件事：PATH 没配对、二进制根本没装上、终端没重开。
确认 $GOPATH/bin 是否在 PATH 里
Buffalo CLI 不会自己往 PATH 里写路径，这步必须手动做。先查 GOPATH：
go env GOPATH —— 输出应类似 /home/you/go 或 /Users/you/go
再查 PATH 是否含对应 bin 目录：
- Linux/macOS：
echo $PATH | grep -o "$GOPATH/bin"，无输出即缺失 - Windows PowerShell：
$env:PATH -split ';' | Select-String 'go\bin'
常见坑：C:Program FilesGoin 是 Go 自身的路径，和 $GOPATH/bin 完全不同；前者放 go 命令，后者才放 buffalo。
检查 buffalo 二进制是否真被安装了
运行 go install github.com/gobuffalo/cli/cmd/buffalo@latest 在 2026 年大概率失败——因为仓库已归档，Go Proxy 不再提供 tag。别硬等超时，直接换方案：
- Linux/macOS：去 GitHub Releases 下载
buffalo_*.tar.gz，解压后把buffalo文件复制到/usr/local/bin，再执行chmod +x /usr/local/bin/buffalo - Windows：用 Scoop（推荐），运行
scoop bucket add extras和scoop install buffalo，它自动注册 PATH - 若你设过
GOBIN，则要查go env GOBIN，并把那个路径加进 PATH，而不是默认的$GOPATH/bin
装完别急着试，which buffalo 或 where buffalo 看是否返回有效路径。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
PATH 改了但还是 command not found
改完 ~/.zshrc 或 ~/.bashrc 后，当前终端不会自动刷新 PATH。必须新开一个终端窗口，再运行：
buffalo version
如果仍报错，说明要么配置写错了（比如多了一个空格、引号不匹配），要么改的不是你当前 shell 正在读的文件（zsh 用户改了 .bashrc 就无效）。验证方式：
- macOS zsh：运行
echo $SHELL确认是/bin/zsh，再确认改的是~/.zshrc - Linux bash：运行
ps -p $$看 shell 名，再确认改的是~/.bashrc或~/.bash_profile
别跳过“新开终端”这步，PATH 变量不会热更新。
buffalo version 能跑但 buffalo new 报错
这是另一个层级的问题：CLI 装对了，但项目初始化失败。最常见原因是 Go 版本太低或模块拉取失败：
- 运行
go version，必须 ≥go1.21；低于此版本，buffalo new会在 plugins 阶段 panic，因为依赖的github.com/gobuffalo/buffalo-plugins已不可用 - 国内用户务必设代理：
go env -w GOPROXY=https://goproxy.cn,direct - 如果仍卡在
loading plugins，立即设环境变量：BUFFALO_PLUGIN_CHECK=false，再跑buffalo new myapp --api --skip-yarn
真正麻烦的不是命令找不到，而是命令找到了，却在第一步就静默失败——这时候得看终端最后一行输出，而不是只盯着 “command not found”。
