buffalo new 是 buffalo 唯一正确且不可跳过的初始化方式，必须在空目录下执行，生成全栈结构后依次运行 go mod tidy、buffalo db create、buffalo db migrate up，否则 buffalo dev 必然失败。
buffalo new 命令能直接初始化项目，但默认不生成前端构建支持
执行 buffalo new myapp 会创建一个完整 Go Web 项目，含路由、模型、模板等结构，但默认使用 packr 打包静态资源，不带 Webpack/Vite 等现代前端构建链路。如果你需要 React/Vue 支持，得加参数或手动补全。
- 基础命令：
buffalo new myapp（生成标准 Buffalo 项目） - 启用 Node.js 前端支持：
buffalo new myapp --with-nodejs（添加assets/目录和package.json） - 跳过数据库初始化：
buffalo new myapp --skip-pop（避免生成 Pop ORM 相关文件） - 指定数据库驱动：
buffalo new myapp --db-type postgres（可选postgres、mysql、sqlite3）
执行 buffalo new 后必须立即运行 buffalo dev，否则静态资源不生效
Buffalo 的开发服务器 buffalo dev 不仅启动 Go HTTP 服务，还会自动监听 assets/ 下的变更并触发构建（如果配置了 --with-nodejs）。只用 go run main.go 会导致 CSS/JS 404，因为打包逻辑由 Buffalo CLI 控制，而非原生 Go。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
-
buffalo dev会自动执行npm run build（或yarn build），前提是package.json中定义了build脚本 - 若修改了
assets/js/application.js但页面没更新，先确认buffalo dev是否在运行——它不是热重载所有前端文件，而是依赖watch配置 - 生产环境需显式运行
buffalo build，它会把构建产物嵌入二进制，buffalo dev不做这步
buffalo new 生成的 Go module 名称必须与当前路径匹配
Buffalo 会读取当前目录名作为 Go module 名（如在 /home/me/myapp 下执行，则 module 是 myapp），并写入 go.mod。如果目录名含点（.）、大写字母或特殊符号，buffalo new 会失败或生成非法 module 名，导致后续 go build 报错。
- 错误示例：
buffalo new my.app→go.mod写入module my.app→ Go 认为这不是合法导入路径 - 安全做法：用小写字母 + 连字符，如
buffalo new blog-api - 若已生成但 module 名异常，手动编辑
go.mod第一行，并运行go mod edit -module your/correct/name同步依赖引用
常见报错 buffalo: command not found 或 failed to initialize app
这两个错误通常不是 Buffalo 本身问题，而是环境未就绪。Buffalo 依赖 Go 工具链和特定版本的 node/npm（如果用了 --with-nodejs），且对 GOPATH 和 Go modules 模式敏感。
-
buffalo: command not found：说明buffalo二进制不在$PATH，检查安装方式——推荐用go install github.com/gobuffalo/buffalo/v2@latest（Go 1.21+），不要用旧版go get -
failed to initialize app：大概率是当前目录下已有go.mod或Gopkg.lock，Buffalo 拒绝覆盖；清空或换目录再试 - Windows 用户注意：PowerShell 中执行
buffalo new可能因路径分隔符报错，改用 Git Bash 或 Windows Terminal + WSL
buffalo dev 直接跑 Go，也别在带空格或点的路径下建项目。
