必须安装github.com/gobuffalo/buffalo/v2@latest，因Go 1.16+模块模式下旧路径失效；需确保GOBIN在PATH中，并用buffalo version验证。
buffalo 命令根本不会被 go install 直接安装
Go 1.16+ 默认禁用 GO111MODULE=off 模式，而旧版 Buffalo 的 buffalo CLI 是以传统 GOPATH 方式发布的，直接运行 go install github.com/gobuffalo/buffalo/buffalo 会失败——它找不到模块定义，或报 no Go files in 错误。
真正可行的路径是：先用 go install 安装一个「模块感知」的、官方维护的替代入口。目前唯一稳定支持的是 github.com/gobuffalo/buffalo/v2@latest（注意 v2 路径和版本后缀）。
- 必须显式指定版本，如
v2或v2.5.0；不带版本号会触发 module lookup 失败 - 确保
GOBIN已加入$PATH，否则装完找不到buffalo命令 - Mac/Linux 下推荐先运行
go env -w GOBIN=$HOME/go/bin，再执行安装
正确执行 go install buffalo/v2 的完整命令
在终端中逐行运行以下命令（顺序不能颠倒）：
go install github.com/gobuffalo/buffalo/v2@latest
安装完成后验证：
buffalo version
输出应类似 v2.5.0（具体版本依当时 latest 而定）。如果提示 command not found，说明 GOBIN 不在 PATH 中，需补加：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- Linux/macOS：在
~/.bashrc或~/.zshrc中追加export PATH=$HOME/go/bin:$PATH，然后source对应文件 - Windows PowerShell：运行
$env:Path += ";$env:GOPATH\bin"（临时），或通过系统属性永久设置
buffalo new 项目时为什么仍报错？检查 Go Module 状态
buffalo new myapp 失败常见于两类问题：
- 当前目录已存在
go.mod，但模块路径（module行）不是空或与项目名冲突 → 删除go.mod再试 - Buffalo v2 默认启用 Go Modules，但你的 Go 环境仍处于
GO111MODULE=auto且当前在 GOPATH 内 → 运行go env -w GO111MODULE=on - 某些插件（如
pop）依赖github.com/gobuffalo/pop/v6，若本地已有旧版v5缓存，可能引发构建失败 → 清理：go clean -modcache
建议新建项目前，先在空目录下执行：go mod init example.com/myapp，再运行 buffalo new . --api（加 --api 可跳过前端工具链，降低首次失败概率）。
别把 buffalo 和 buffalo-cli 混为一谈
GitHub 上存在两个长期并存的仓库：gobuffalo/buffalo（主框架 + CLI）和早已归档的 gobuffalo/buffalo-cli。后者是 v0.x 时代的独立 CLI，现已废弃。
- 所有文档里提到的
buffalo命令，都指向gobuffalo/buffalo/v2这个模块 - 如果你曾装过
buffalo-cli，请先运行which buffalo确认二进制来源，必要时手动删掉旧版（如/usr/local/bin/buffalo） - v2 CLI 内置了
buffalo fix命令，可自动升级老项目到新模块结构，但对非模块项目无效
真正麻烦的从来不是安装命令本身，而是环境里残留的 GOPATH 习惯、未清理的 modcache、以及误信过期教程里的 go get 写法。
