本文详解在 windows 环境下基于 godep 管理依赖的 go 项目如何部署至 heroku，涵盖环境准备、godeps.json 生成、procfile 配置及推送部署全流程。
本文详解在 windows 环境下基于 godep 管理依赖的 go 项目如何部署至 heroku，涵盖环境准备、godeps.json 生成、procfile 配置及推送部署全流程。
Heroku 对 Go 应用提供了原生支持，其构建流程会自动识别项目根目录下的 Godeps/Godeps.json 文件，并据此还原依赖、编译二进制文件。即使你在 Windows 32 位系统（如 GOARCH=386, GOOS=windows）上开发，只要最终构建目标与 Heroku 运行环境一致（Linux AMD64），就能顺利完成部署——关键在于确保构建过程在 Heroku 的 Linux 环境中执行，而非本地 Windows 环境。
✅ 前置准备
-
安装 Heroku CLI（替代旧版 Toolbelt）：
下载并安装 Heroku CLI，然后登录：heroku login
-
初始化 Git 仓库（若尚未初始化）：
git init git add . git commit -m "initial commit"
-
创建 Heroku 应用：
heroku create your-app-name # 名称可选，不填则自动生成
✅ 正确生成 Godeps.json（关键步骤）
⚠️ 注意：Godep 必须在 Linux 兼容目标环境下（即 GOOS=linux GOARCH=amd64）生成依赖快照，否则 Heroku 构建会失败。请勿直接使用当前 Windows 环境（GOOS=windows）运行 godep save。
在项目根目录执行（推荐使用 PowerShell 或 CMD）：
# 临时切换为 Heroku 构建目标环境 set GOOS=linux set GOARCH=amd64 # 确保 GOPATH 设置正确（建议指向你的项目所在 GOPATH） # 然后保存依赖（-r 表示递归保存所有依赖包） godep save -r ./...
该命令会在项目根目录生成 Godeps/ 目录及 Godeps.json 文件，这是 Heroku 构建器识别 Go 项目的标志。
? 验证：打开 Godeps.json，确认其中 "ImportPath" 和 "GoVersion" 字段存在，且 Godeps 数组非空。
✅ 编写 Procfile（必需）
Heroku 通过 Procfile 指定启动命令。它必须位于项目根目录，且无扩展名，内容格式为：
web: your-binary-name
其中 your-binary-name 是 Go 编译后生成的可执行文件名（不含 .exe 后缀）。Heroku 使用 go build 编译，输出为 Linux 可执行文件（无扩展名）。
例如，若主程序入口为 cmd/myapp/main.go，则构建后二进制名为 myapp：
web: myapp
? 提示：你可在 main.go 中添加 log.Println("Server starting on :", os.Getenv("PORT")) 并监听 os.Getenv("PORT")，确保适配 Heroku 动态端口分配。
✅ 部署与验证
完成上述配置后，提交并推送：
git add Godeps/ Procfile git commit -m "add Godeps and Procfile for Heroku" git push heroku main # 或 master（取决于默认分支）
Heroku 日志将显示构建过程：自动检测 Go、读取 Godeps.json、go install 编译、运行 web 进程。部署成功后，可通过：
heroku open
或访问 https://your-app-name.herokuapp.com 验证服务是否正常响应。
⚠️ 常见问题提醒
- ❌ 不要提交 Windows 生成的 .exe 文件；Heroku 构建器会重新编译。
- ❌ 不要在 Godeps.json 中保留 GOOS=windows 相关字段；确保 godep save 在 GOOS=linux 下执行。
- ✅ 推荐升级至 Go Modules（go mod）：Godep 已停止维护，Heroku 同样支持 go.mod，更简洁可靠。
- ✅ 若遇 cannot find package 错误，请检查 Godeps.json 是否遗漏依赖，或尝试 godep restore 本地验证。
遵循以上流程，即可稳定、可复现地将 Windows 开发的 Go 应用部署至 Heroku 生产环境。
