Buffalo项目创建后必须立即执行三件事：先go mod tidy拉取并锁定依赖，再检查database.yml中数据库URL是否可连，最后若为纯API项目须删除assets/目录以防Webpack编译失败。
buffalo new 创建项目后必须立即执行的三件事
刚跑完 buffalo new myapp，别急着写代码——有三个动作不立刻做，后续 80% 的报错都源于此。
- 进项目根目录，立刻运行
go mod tidy：Buffalo 生成的go.mod常含未 resolve 的间接依赖（比如github.com/gobuffalo/pop/v6版本冲突），tidy会拉取并锁定真实可用版本 - 检查
database.yml中的url字段是否可连：默认是postgres://localhost:5432/myapp_development，若没装 PostgreSQL 或端口不对，buffalo db create会卡住或报dial tcp [::1]:5432: connect: connection refused - 删掉
assets/目录（如果不需要前端）：纯 API 项目留着它会导致buffalo dev启动时卡在 webpack 编译，且buffalo build会尝试打包不存在的 JS/CSS
buffalo dev 启动失败常见原因与修复
buffalo dev 报错「listen tcp :3000: bind: address already in use」或「no such file or directory」，基本不是 Buffalo 问题，而是环境没对齐。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 端口被占：用
lsof -i :3000（macOS/Linux）或netstat -ano | findstr :3000（Windows）查 PID，再kill -9 PID；也可改端口：buffalo dev -p 4000 - 找不到
buffalo命令：确认$GOPATH/bin在$PATH中，或直接用go run github.com/gobuffalo/cli/cmd/buffalo@latest dev - 报
template: index.html:1: function "t" not defined：说明你删了templates/但没同步删掉actions/app.go里的app.Use(plugins.Static())和app.GET("/", HomeHandler)路由——这两者必须一起删
Go 编辑器识别 Buffalo 项目的关键配置点
VS Code 或 GoLand 打开项目后，actions.App() 报 unresolved、跳转不到 User 模型，不是插件没装好，而是模块索引没触发。
- VS Code：确保已运行
Go: Install/Update Tools并勾选gopls；项目根目录下建.vscode/settings.json，内容为{"go.useLanguageServer": true, "go.toolsManagement.autoUpdate": true}；改完重启窗口，等右下角 “Indexing…” 消失 - GoLand：导入时选 “Go module”，不要选 “Empty project”；导入后右键项目名 → “Reload project”，否则
models/目录不会被识别为源码包 - 所有编辑器共性坑：别手动把
actions/或models/标为 Sources Root——Buffalo 依赖go.mod定义模块边界，手动标记反而破坏 GOPATH 自动推导
第一次数据库迁移前必做的校验项
buffalo db migrate 成功不等于模型能用，字段映射错误往往到 c.Bind() 或查询时才暴露。
- 模型结构体每个字段必须同时带
json和db标签，例如Name string `json:"name" db:"name"`；漏掉任一标签，Pop 读写会静默失败 - 主键字段必须显式声明
db:"id,primarykey"，不能只写db:"id"；UUID 类型需导入github.com/google/uuid并用uuid.UUID类型 - 时间戳字段如
CreatedAt time.Time `json:"created_at" db:"created_at"`，不能用string类型硬转——Pop 不会自动解析字符串为 time.Time - 可空字段（DB 允许 NULL）必须用指针类型，例如
Email *string `json:"email" db:"email"`；用string类型会导致空字符串写入，无法表达“未提供”语义
actions/app.go 里默认启用了 plugins.Favicon() 和 plugins.Static()，纯 API 项目不删它们，不仅启动慢，还会让 curl -I http://localhost:3000/favicon.ico 返回 200 —— 这种隐式行为在压测或网关路由中可能引发意料外的流量穿透。 
