Buffalo框架必须用go install安装CLI工具，不能用go get；项目初始化后需立即执行go mod tidy，否则依赖缺失或版本错乱，且须手动导入数据库驱动并配置.env文件确保配置生效。
Buffalo 框架必须用 go install 安装 CLI 工具，不能用 go get；项目初始化后需立即执行 go mod tidy，否则后续所有依赖（如 pop、gorilla/sessions）都会缺失或版本错乱。
安装 buffalo CLI 必须用 go install
Go 1.21+ 已弃用 go get 安装可执行工具的能力，go get github.com/gobuffalo/cli/cmd/buffalo@latest 会静默失败或只下载源码不生成二进制。正确命令是：
go install github.com/gobuffalo/cli/cmd/buffalo@latest
安装后验证：buffalo version 应输出类似 v1.0.1 的版本号。若提示 command not found，检查 $GOPATH/bin 是否在 $PATH 中（macOS/Linux 可加 export PATH=$PATH:$GOPATH/bin 到 shell 配置）。
创建项目后必须立刻 go mod tidy
运行 buffalo new myapp --db-postgres（或 --db-sqlite3）生成的项目，其 go.mod 文件仅声明了 buffalo 核心依赖，但 pop、gorilla/sessions、github.com/google/uuid 等 runtime 依赖并未写入——它们藏在 buffalo 的内部 replace 或间接引用里，不执行 tidy 就不会解析落地。
- 进入项目根目录后，立即运行
go mod tidy - 若报错
no required module provides package github.com/gobuffalo/pop/v6，说明 GOPROXY 不可用，临时换为export GOPROXY=https://proxy.golang.org,direct再试 -
go.mod中应出现github.com/gobuffalo/pop/v6 v6.19.0等明确版本，而非// indirect行
数据库驱动需手动启用对应 import
Buffalo 默认生成的 models/models.go 里，pop.Connect() 调用依赖具体驱动注册，但驱动包本身不会自动 import。例如选 PostgreSQL，必须手动在 models/models.go 开头补上：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
import _ "github.com/gobuffalo/pop/v6/soda"
否则运行 buffalo db create 时会 panic：no driver for postgres。同理：
- SQLite：加
import _ "github.com/gobuffalo/pop/v6/soda"（soda 同时支持 sqlite3） - MySQL：加
import _ "github.com/gobuffalo/pop/v6/mysql" - 不加下划线
_会导致包未被链接，import 行无效
buffalo dev 启动前要确认 .env 文件存在
buffalo dev 默认读取项目根目录下的 .env 文件来设置数据库连接串（DATABASE_URL）、会话密钥（SESSION_SECRET）等。该文件不存在时，框架不会报错，而是 fallback 到硬编码的默认值（如 sqlite3://./development.sqlite），极易导致本地开发连错库或 session 失效。
建议初始化时就创建一个最小可用的 .env：
DATABASE_URL=postgres://localhost:5432/myapp_development?sslmode=disable SESSION_SECRET=change-me-to-32-byte-random-string
注意：
-
SESSION_SECRET必须是至少 32 字节的随机字符串，否则启动时会 panic：key must be at least 32 bytes long - PostgreSQL 用户确保
localhost:5432上已有空数据库myapp_development，否则buffalo dev会卡住或报连接超时
最易忽略的是 go mod tidy 和 .env 两步——前者让依赖真正“落地”，后者让配置真正“生效”。跳过任一，buffalo dev 表面能跑起来，但数据库操作、session、甚至路由中间件都可能静默失效。
