Buffalo框架首次运行需依次完成依赖安装、数据库初始化与迁移、开发服务器启动三步：先go mod tidy和npm install，再buffalo db create与migrate，最后buffalo dev启动服务。
Buffalo框架第一次运行项目前必须完成依赖安装、数据库初始化和开发服务器启动三个不可跳过的环节，缺一不可，否则buffalo dev会因缺少models连接或静态资源构建失败而报错退出。
安装项目依赖
进入项目根目录后，先执行go mod tidy拉取所有Go依赖，包括github.com/gobuffalo/buffalo、github.com/gobuffalo/pop/v6等核心组件。这一步不能省略——Buffalo CLI生成的go.mod只声明了顶层依赖，子依赖需显式补全，否则后续迁移或数据库操作会panic。
接着运行npm install（或yarn install）安装前端资产依赖。即使你打算删掉assets/目录，首次运行也必须执行，因为buffalo dev启动时默认尝试编译Webpack，找不到node_modules会直接中断。
初始化数据库并执行迁移
确认database.yml中development环境配置正确，尤其是dialect（如postgres）、database名和host地址。若用SQLite，确保系统已安装gcc——否则go build阶段会因sqlite3驱动编译失败而终止。
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
执行buffalo db create创建数据库实例。该命令依赖database.yml中定义的库名和用户权限，若提示permission denied，需先用数据库管理员账号手动建库并赋权。
【必须按顺序执行】紧接着运行buffalo db migrate。此命令会扫描migrations/目录下所有未执行的SQL文件（按文件名时间戳升序），逐条应用到数据库。跳过这步会导致models.NewDB()连接后查询表时返回table not found错误。
启动开发服务器
执行buffalo dev启动热重载服务。它会自动监听actions/、models/、templates/等目录变更，并在代码修改后重新编译二进制、重启HTTP服务。
服务默认运行在http://localhost:3000。如果端口被占用，可在config/env.go中修改AppPort字段，或临时加参数buffalo dev -p 4000指定新端口。
