必须先安装buffalo CLI,否则buffalo new、buffalo dev等命令均报command not found;需确保Go≥1.21(推荐1.26.0)、GOPATH/bin已加入PATH,再执行go install github.com/gobuffalo/cli/cmd/buffalo@latest,最后用buffalo version验证。

必须先装 buffalo CLI,否则所有后续命令(如 buffalo new、buffalo dev)都会报 command not found。Go 环境和 PATH 配置是两个最常卡住的环节,缺一不可。
确认 Go 版本不低于 1.21
Buffalo CLI 是用 Go 写的,依赖 Go 的模块系统和构建工具。执行:
go version
输出必须为 go1.21 或更高(推荐 go1.26.0)。若低于此版本:
- 可能触发
go install编译失败 - 或拉取依赖时因模块兼容性报错
未安装 Go?去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载 1.26.0 安装包,并确保 go 命令可全局调用。
确保 GOPATH/bin 在系统 PATH 中
go install 默认把二进制放到 $GOPATH/bin,但不会自动加到 PATH。执行:
go env GOPATH
记下返回路径(如 /home/you/go),然后检查:
echo $PATH | grep -o "$GOPATH/bin"
若无输出,需手动添加。例如 Bash/Zsh 用户在 ~/.zshrc 或 ~/.bashrc 末尾加:
export PATH="$GOPATH/bin:$PATH"
然后运行 source ~/.zshrc 生效。Windows 用户请将 %USERPROFILE%\go\bin 加入系统环境变量 PATH。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
安装 buffalo CLI 的两种方式
推荐优先用 go install,它能保证与本地 Go 工具链一致:
go install github.com/gobuffalo/cli/cmd/buffalo@latest
若提示 cannot find module providing package,大概率是网络问题或 Go 版本过低,此时改用预编译包:
- Linux/macOS:去 GitHub Releases 下载
buffalo_*.tar.gz,解压后复制buffalo二进制到/usr/local/bin并chmod +x - Windows:用 Scoop(推荐):
scoop bucket add extras && scoop install buffalo
注意:安装后务必新开终端窗口验证,旧终端不会自动加载更新后的 PATH。
验证安装是否真正生效
在新终端中执行:
buffalo version
应输出类似 v0.18.13 的版本号。若仍报 command not found,90% 是 PATH 没生效——别跳过这步,这是新手踩坑率最高的环节。
PATH 配置错误时,buffalo 文件其实已存在,只是 shell 找不到。别重装,先查 ls $GOPATH/bin/buffalo 确认文件存在,再盯紧 PATH 是否包含该路径。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










