buffalo cli 必须先安装，否则所有命令均无法执行；项目依赖分 go（需 go mod tidy 补全子模块如 pop/v6）和前端（npm install 或 --skip-yarn 规避）两层，顺序不可颠倒，且 gopath/bin 未入 path、go 版本低于 1.21 或网络问题均为常见失败原因。
Buffalo CLI 必须先装，否则所有命令都执行不了；项目依赖分 Go 和前端两层，缺一不可，且顺序不能乱。
buffalo CLI 安装失败常见原因
最常卡在 go install github.com/gobuffalo/cli/cmd/buffalo@latest 报错，本质就两类问题：
- Go 版本低于 1.21 —— 运行
go version确认，旧版本会触发编译失败 -
$GOPATH/bin没进系统PATH—— 新开终端后buffalo version找不到命令，就是这个原因
如果公司内网或 GitHub 访问不稳定，改用预编译包更稳：下载 buffalo_*.tar.gz，解压后把 buffalo 二进制丢进 /usr/local/bin/（macOS/Linux）或 %USERPROFILE%\scoop\shims\（Windows + Scoop），再 chmod +x 或直接 scoop install buffalo。
go mod tidy 为什么不能跳过
go mod tidy 不只是“拉依赖”，它会补全 github.com/gobuffalo/pop/v6 这类子模块，而 Buffalo CLI 生成的 go.mod 只写顶层引用。跳过会导致后续 buffalo db migrate 直接 panic，错误像：panic: no driver for postgres。
顺手加个代理提速：
go env -w GOPROXY=https://goproxy.cn,direct
再跑 go mod tidy，国内源通常快 3～8 倍。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
npm install 或 yarn install 为什么首次必须执行
buffalo dev 启动时默认调用 Webpack 编译 assets，哪怕你删了 assets/ 目录，只要 buffalo.yml 里 assets 配置没关，它就会去找 node_modules。找不到就中断，报错类似：exec: "yarn": executable file not found in $PATH 或 Cannot find module 'webpack'。
如果你确定不需要前端资产，创建项目时就加 --skip-yarn：
buffalo new myapi --api --skip-yarn
这样从源头避开 node_modules 拉取，省掉 30 秒～2 分钟等待，也避免 registry 不可达导致整个 buffalo new 失败。
依赖缓存和插件检查怎么关
Buffalo 每次 buffalo dev 都会联网检查插件更新（比如 buffalo-pop），网络差时卡住 10 秒以上。关掉它：
- 手动安装插件到本地：
buffalo plugins install github.com/gobuffalo/buffalo-pop/v3，二进制会缓存在$HOME/.buffalo/plugins/ - 在
config/env.go的app.Init()前加一行：os.Setenv("BUFFALO_PLUGIN_CHECK", "false")
注意：这行代码位置很关键，放错地方就无效；另外别删 $HOME/.buffalo/plugins/，否则下次又得联网重下。
真正容易被忽略的是：Buffalo 的依赖管理不是单点操作，而是 Go 模块、前端包管理、CLI 插件三套机制并存，各自有缓存路径和校验逻辑。一个环节断掉，整个开发流就卡死——比如 go mod tidy 成功但 buffalo db create 报错，大概率是 pop 插件没装或版本不匹配，而不是数据库连不上。
