Buffalo命令找不到是因GOPATH/bin或GOBIN未加入PATH或未成功安装；需验证go version和go env GOPATH，执行go install github.com/gobuffalo/buffalo/v2@latest，并确保$GOPATH/bin在PATH中。
buffalo命令找不到或报“command not found”
这是最常见的一类环境问题，本质是Go的$GOPATH/bin或$GOBIN没进系统PATH，或者Buffalo根本没安装成功。
先验证Go环境是否就绪：go version 和 go env GOPATH 必须能正常输出；再检查Buffalo是否真被安装：go install github.com/gobuffalo/buffalo/v2@latest（注意v2后缀，v1已废弃）——这行命令必须完整执行完，不能中途Ctrl+C。
- Linux/macOS：确认
$GOPATH/bin在$PATH中，例如export PATH=$PATH:$GOPATH/bin写入~/.bashrc或~/.zshrc后重载 - Windows：用PowerShell运行
$env:PATH += ";$env:GOPATH\bin"，或在系统环境变量里手动添加 - 如果用
go install后仍无效，尝试加-v参数看具体失败点，常见于proxy设置或go.sum校验失败
buffalo new myapp失败，卡在“generating…”或报模板错误
Buffalo依赖远程模板仓库生成项目骨架，网络不稳定或代理配置不当会导致拉取失败，错误信息常含template: ...: no such template或Get "https://...": context deadline exceeded。
默认模板地址是https://github.com/gobuffalo/buffalo-plugins及其子模块，国内访问慢。可临时切换为镜像源：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 执行前设置环境变量：
export BUFFALO_PLUGIN_REPO=https://ghproxy.com/https://github.com/gobuffalo/buffalo-plugins - 或改用离线方式：先
git clone https://ghproxy.com/https://github.com/gobuffalo/buffalo-plugins到本地，再用buffalo new myapp --plugin-repo /path/to/local/buffalo-plugins - 注意：不要用
buffalo new --api跳过前端时还强行指定--with-dep，二者冲突会触发内部模板解析异常
VS Code里无法识别Buffalo项目结构，gopls报错或跳转失效
Buffalo项目不是普通Go module，它依赖main.go和app.go的固定入口约定，gopls若未正确加载module根目录，就会丢失类型推导和符号索引。
关键动作不是装插件，而是确保VS Code打开的是**项目根目录**（即含go.mod、main.go、actions/app.go的那层），而不是上层父文件夹。打开后等待右下角状态栏gopls图标稳定显示绿色，而非“Loading…”或报no go.mod file。
- 若仍报错，检查
go.mod第一行是否为module github.com/yourname/myapp——Buffalo要求module路径与实际导入路径一致，否则gopls无法解析github.com/gobuffalo/buffalo等依赖的内部引用 - 删掉
.vscode/settings.json里所有自定义go.goroot或go.toolsEnvVars，让扩展自动探测 - 禁用其他Go相关插件（如旧版Go for Visual Studio Code），只留官方
golang.go
buffalo dev启动后页面空白或404，但终端无报错
这通常不是代码逻辑问题，而是assets未构建或templates路径不匹配导致的静默失败。Buffalo在dev模式下不会提前校验HTML模板是否存在，而是在首次请求时才尝试渲染，失败就返回空响应。
先确认两件事：assets/js/application.js是否存在？templates/home/index.html是否存在？前者缺失会导致前端白屏，后者缺失会导致c.Render(200, r.HTML("home/index.html"))找不到模板，返回200但body为空。
- 运行
npm run build（或yarn build）确保assets打包完成，public/assets/下有生成的js/css文件 - 检查
actions/home.go中r.HTML("xxx")的参数路径，必须和templates/下的文件路径完全一致，包括大小写和斜杠方向 - 临时在
app.Use(mw.Logger)后加一行app.Use(func(next buffalo.Handler) buffalo.Handler { return func(c buffalo.Context) error { log.Printf("REQ: %s %s", c.Request().Method, c.Request().URL.Path); return next(c) } })，看请求是否真的到达了handler
buffalo dev默认不监听localhost以外的地址，如果你用curl http://192.168.x.x:3000访问失败，不是端口问题，而是服务压根没绑定到该IP——得加-b 0.0.0.0参数显式指定绑定地址。 
