Go migrate安装失败主因是Go模块模式与仓库地址不匹配，应使用go install github.com/golang-migrate/migrate/v4/cmd/migrate@latest；连接PostgreSQL需用postgres://而非pgx://并确保驱动已注册；SQL迁移文件须按20230405123000_create_users_table.up.sql格式命名；程序内迁移推荐SDK但需手动导入驱动，CLI更适配部署。
Go migrate 工具安装失败：常见原因和解决办法
直接用 go install 装不上 migrate，大概率是 Go 版本或模块模式没对上。Go 1.16+ 默认启用 GO111MODULE=on，而官方 migrate 仓库（github.com/golang-migrate/migrate）已归档，新地址是 github.com/golang-migrate/migrate/v4，老命令会失效。
- 用这个命令装最新稳定版：
go install github.com/golang-migrate/migrate/v4/cmd/migrate@latest - 如果提示
command not found: migrate，检查$GOPATH/bin是否在$PATH中（macOS/Linux 看echo $PATH，Windows 看系统环境变量） - Windows 用户若用 PowerShell，可能需运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser才能执行本地二进制
migrate CLI 连接 PostgreSQL 报错 “driver: unknown driver pgx”
migrate 默认不带数据库驱动，必须显式指定并确保对应驱动已安装。PostgreSQL 常用 pgx，但它不是内置驱动 —— migrate 只认注册过的 driver 名，比如 postgres 或 pgx，但后者需要你编译时嵌入或用预编译二进制。
- 最稳方案：用官方预编译二进制（GitHub Releases 页面），它已打包
postgres、mysql、sqlite3驱动 - 若坚持源码编译，得自己改
main.go引入_ "github.com/jackc/pgx/v5"并注册，再go build—— 多数人没必要走这步 - 连接字符串里别写
pgx://，要用postgres://（即使底层用 pgx），否则报 driver unknown
迁移文件命名不规范导致 migrate up 报错 “no such file”
migrate 对 SQL 文件名有严格格式要求，不是随便起个 init.sql 就能识别。它依赖文件名里的时间戳或序号来排序执行顺序，且扩展名必须匹配后端类型。
- 正确命名示例：
20230405123000_create_users_table.up.sql（时间戳 + 描述 +.up.sql） - 支持的后缀只有：
.up.sql、.down.sql、.up.pgsql、.down.pgsql等，不能用.sql单独结尾 - 路径必须是相对当前工作目录的，比如
migrate -path ./migrations -database "postgres://..." up，./migrations下必须有至少一个合法命名的 .up 文件
Go 项目里用 migrate 库做程序内迁移 vs CLI 的取舍
别在生产代码里调 exec.Command("migrate", ...)。Go 官方推荐用 migrate 的 Go SDK（github.com/golang-migrate/migrate/v4），但要注意：它不自动加载驱动，必须手动注册。
立即学习“go语言免费学习笔记（深入）”；
- 必须 import 对应驱动包，例如：
_ "github.com/golang-migrate/migrate/v4/database/postgres"和_ "github.com/golang-migrate/migrate/v4/source/file" -
migrate.New()返回的实例默认不校验 migration 文件完整性，上线前建议加m.Up(migrate.All)后立刻m.Close()，避免句柄泄漏 - CLI 更适合部署脚本或 CI，SDK 更适合嵌入启动逻辑（比如服务启动时自动 migrate），但 SDK 错误处理更琐碎 —— 比如
no change是正常返回，不是 error
真正麻烦的是 migration 文件的版本管理和团队协作：同一个 .up.sql 被多人修改、未同步更新 down 文件、SQL 里写了数据库特定语法（比如 GENERATED ALWAYS AS IDENTITY 在旧 PostgreSQL 不支持）—— 这些问题不会在 migrate up 成功时暴露，但会在恢复或回滚时卡住。
