必须用 go install github.com/gobuffalo/cli/cmd/buffalo@latest 安装 Buffalo CLI，因其本质是开发期命令行工具而非可 import 的 Go 库；go get 不编译二进制，import 无意义，且仓库重定向、路径缺 /cmd/buffalo 或未指定 @latest 均会导致失败。
必须用 go install 安装 buffalo CLI，不是框架库本身——Buffalo 没有“框架组件”可导入，它的核心就是这个命令行工具。
为什么不能 go get 或直接 import buffalo？
Buffalo 不是传统意义上的 Go 库（比如 gin 或 gorilla/mux），它不提供可被 import 的包供你手写路由或中间件。所有功能都封装在 buffalo 二进制中：buffalo new 生成项目、buffalo dev 启动服务、buffalo g resource 生成代码——这些都不是运行时依赖，而是开发期脚手架行为。
试图 go get github.com/gobuffalo/buffalo 会失败，因为该路径已重定向到新仓库；而 go get github.com/gobuffalo/cli 下载的是源码，但不会自动编译成可用命令，仍需 go install。
go install 的正确写法和常见报错
执行这条命令才是唯一可靠路径：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
- 必须带
/cmd/buffalo子路径，漏掉就会提示no matching versions或cannot find module providing package - 必须指定
@latest（或具体版本如@v0.18.13），否则 Go 1.21+ 默认不解析无版本 tag 的仓库 - 如果报
command not found后续验证，大概率是$GOPATH/bin没进PATH——别只查go env GOPATH，还要确认echo $PATH | grep "$(go env GOPATH)/bin" - 国内网络不稳定时，先设代理：
export GOPROXY=https://proxy.golang.org,direct或换为阿里云镜像
安装后能直接用哪些命令？
装完就只有 buffalo 这一个命令可用，所有功能都通过子命令展开：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
buffalo new myapp：初始化项目（必须在空目录） -
buffalo dev：启动开发服务器（不自动跑迁移，得先buffalo db migrate） -
buffalo g resource users name email：一键生成 model + handler + template + route + migration -
buffalo routes：查看当前注册的所有路由（含中间件标记） -
buffalo build --static：构建前端资源到public/，用于 Nginx 托管
注意：buffalo 命令本身不依赖当前目录是否有 go.mod，但它的子命令（如 buffalo dev）必须在项目根目录运行，且该目录下要有有效的 go.mod。
别被“组件”这个词带偏：Buffalo 没有 runtime 插件机制
文档里提到的 buffalo-plugins（如 buffalo-pop）本质是 CLI 插件，不是 Go 包。安装方式是：
buffalo plugins install github.com/gobuffalo/buffalo-pop
它只是让 buffalo db migrate 等命令多出数据库操作能力，底层仍是调用 pop 库——但你不能也不需要在代码里 import "github.com/gobuffalo/pop/v6" 来手动操作，Buffalo 的设计哲学是“CLI 驱动，生成即用”。
真正容易忽略的点是：一旦你开始手改 actions/app.go 或自定义中间件，就已脱离 Buffalo 的“标准路径”，后续升级 CLI 或切换模板引擎时，生成器不再覆盖你的修改，维护责任完全落到自己肩上。
