先删go.sum和vendor/，再运行go mod tidy -v，最后执行go clean -modcache——三步解决cannot find package问题，因Buffalo依赖Go工具链而非自身命令管理。
buffalo dev 报 cannot find package 怎么修
这不是 Buffalo 命令本身的问题，而是 Go modules 状态和项目依赖没对齐。Buffalo 不提供独立的依赖管理命令（比如 buffalo mod tidy），所有依赖操作必须走标准 Go 工具链。
常见现象：终端输出 cannot find package "github.com/gobuffalo/pop/v6" 或 undefined: session.Middleware，但 go build 能过，buffalo dev 却挂掉。
- 先删掉
go.sum和vendor/（如果项目启用了 vendor）——避免校验和残留导致后续go mod同步失败 - 运行
go mod tidy -v：它会扫描全部import，补全缺失项（如pop/v6、buffalo-pop/v2），移除未引用项，并重写go.sum - 再执行
go clean -modcache：这一步常被跳过，但 Buffalo 启动时若复用旧缓存，仍可能加载错版本的包
第三方 store（如 Redis session）不生效怎么办
比如你 import 了 "github.com/gobuffalo/buffalo-session/redis"，但 redis.NewStore 报未定义，说明模块没真正拉进项目。
关键点在于：Buffalo 的 session store 不是独立模块，而是通过主模块 github.com/gobuffalo/buffalo-session 统一暴露的。子路径（如 /redis）不会单独出现在 go.mod 中。
- 确认 import 路径是
"github.com/gobuffalo/buffalo-session/redis"，不是旧版"github.com/gobuffalo/buffalo/middleware/session" - 运行
go mod tidy后，检查go.mod是否出现这一行：github.com/gobuffalo/buffalo-session v1.0.0（注意没有/redis后缀） - 若仍报错，手动加
replace（Buffalo v1.0.1 常见）：replace github.com/gobuffalo/buffalo-session => github.com/gobuffalo/buffalo-session v1.0.0
buffalo CLI 和项目依赖版本不一致会怎样
这是最隐蔽也最致命的问题：CLI 工具（buffalo 二进制）和项目 runtime 依赖（github.com/gobuffalo/buffalo）是两套东西，必须版本对齐。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
现象：明明 buffalo version 显示 v2.5.0，go.mod 里也写了 github.com/gobuffalo/buffalo/v2 v2.5.0，但 app.Use(session.Middleware()) 静默失败，或生成的代码调用不存在的方法。
- CLI 版本用
go install github.com/gobuffalo/cli/cmd/buffalo@v2.5.0控制 - 项目依赖版本锁在
go.mod的github.com/gobuffalo/buffalo/v2行，不能靠go get随意升级 - 二者小版本号最好完全一致（如都是 v2.5.0），否则
buffalo g resource生成的签名可能和 runtime 不兼容
CI 流水线里依赖总卡住，该跑哪些命令
Buffalo 的测试、迁移、构建命令内部会动态 import 模块，只跑 go build 是不够的。
错误做法：在 CI 里只做 go mod download 或干脆跳过依赖拉取，结果 buffalo test 直接卡在 loading modules...。
- 必须执行
go mod download（不是go mod tidy）——它只下载不修改go.mod，适合只读环境 - 确保
BUFFALO_ENV=test已设，否则buffalo test可能误读开发配置并尝试连真实 DB - 数据库初始化要绕过真实连接：用
echo 'test:\n dialect: sqlite3\n database: ./test.db' > database.yml+buffalo pop create -e test
真正麻烦的从来不是命令记不住，而是 CLI、runtime、Go 缓存、vendor 四者状态不同步时，错误信息根本不告诉你哪一层出了问题。
