# 使用 Homebrew, dnf, Nix, scoop, apt 安装 golang-migrate

查看 golang-migrate 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:golang-migrate
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install golang-migrate
```

  证据: local Homebrew formula metadata

### Linux

- dnf (92%):

```sh
sudo dnf install migrate
```

  证据: Fedora Rawhide package metadata: migrate from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#migrate
```

  证据: nixpkgs package indexes: pkgs/by-name/mi/migrate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- Ubuntu apt (92%):

```sh
sudo apt install python-migrate-doc
```

  证据: Ubuntu 24.04 LTS package indexes: python-migrate-doc from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz

### Windows

- Scoop (92%):

```sh
scoop install main/migrate
```

  证据: Scoop official bucket manifest trees: bucket/migrate.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:golang-migrate
- **软件包管理器:** Homebrew
- **版本:** 4.19.1
- **来源摘要:** Database migrations CLI tool
- **主页:** <https://github.com/golang-migrate/migrate>
- **仓库:** <https://github.com/golang-migrate/migrate>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- migrate (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.19.1
## 项目历史与用法

golang-migrate is a Go database migration project distributed as both a CLI and a Go library. It applies ordered migration files from source drivers to database drivers, deliberately keeping database drivers simple while centralizing migration logic in the core package.

### 项目历史

The project traces back to `mattes/migrate`, a database migration repository created in 2014. The maintained `golang-migrate/migrate` repository was created in January 2018 and states that it was forked from `mattes/migrate`.

The fork preserved the core CLI/library model while continuing the driver architecture. Its README documents a broad matrix of database drivers, including PostgreSQL, MySQL/MariaDB, SQLite, SQL Server, Cassandra/ScyllaDB, ClickHouse, MongoDB, CockroachDB, and cloud-oriented sources such as GitHub, GitLab, S3, and Google Cloud Storage.

The project standardized on Go module import paths for v4 and explicitly marks v3 as unsupported in its README. That version boundary matters because many Go projects embed migration support directly in their own binaries rather than only shelling out to the CLI.

### 采用历史

golang-migrate became a common Go ecosystem migration tool because it works both as a standalone `migrate` binary and as an importable library. The README points to packagecloud deb packages, Docker images, GitHub releases, and Go documentation, while the batch input records Homebrew, Fedora, Nix, Scoop, and other package-manager entries.

The maintained fork's GitHub repository had over 18,000 stars and more than 1,500 forks in the 2026 GitHub API snapshot used for this batch, making it one of the better-known Go-native database migration tools.

### 使用方式

The standard workflow is to create paired up/down SQL files with `migrate create`, then run them with a source such as `file://path/to/migrations` and a database URL. The getting-started guide emphasizes running migrations up, down, and up again before committing them.

Operationally, golang-migrate is intentionally explicit: the README says the CLI has no config search paths, no config files, and no magic environment-variable injection. Users pass source and database URLs directly, and database credentials normally live in those URLs or in caller-managed secret handling rather than in a tool-owned credentials file.

The getting-started guide highlights dirty database states, force operations, idempotent migrations, transaction wrapping, and database locking when multiple app instances may run migrations. Those warnings are why package users often treat `migrate` as deployment infrastructure rather than a casual development helper.

### 为什么软件包爱好者会关心

For package nerds, golang-migrate is the archetypal Go single-binary infrastructure tool: it can be installed from Homebrew, run from Docker, vendored as a library, or baked into a release artifact. The driver split also makes downstream builds interesting, because packagers and application authors decide which database/source drivers to include.

Its significance is also cultural: it represents the Go preference for explicit URLs, small binaries, and predictable failure over framework-managed migration magic. That makes it popular in CI pipelines and container entrypoints where reproducibility beats convenience.

### 时间线

- 2014: `mattes/migrate` repository created for database migrations in Go.
- 2017: `mattes/migrate` v3 preview releases published.
- 2018: `golang-migrate/migrate` repository created as a fork of `mattes/migrate`.
- 2018: `golang-migrate/migrate` v3.1.0 and later v3 releases published.
- 2019-2026: v4 import path and driver ecosystem documented as the supported line; v3 documented as unsupported.

### Related projects

- `mattes/migrate` is the direct upstream ancestor named by the maintained repository.
- The README points users coming from other migration systems to `migradaptor`, and it links broader database-tool alternatives through Awesome Go.
- Database and source drivers connect golang-migrate to PostgreSQL, MySQL/MariaDB, SQLite, MongoDB, ClickHouse, SQL Server, GitHub, GitLab, S3, and Google Cloud Storage workflows.

### 来源

- <https://github.com/golang-migrate/migrate>
- <https://github.com/golang-migrate/migrate/blob/master/GETTING_STARTED.md>
- <https://github.com/golang-migrate/migrate/releases>
- <https://github.com/mattes/migrate>
- <https://github.com/mattes/migrate/releases>
- <https://pkg.go.dev/github.com/golang-migrate/migrate/v4>


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal

## 其他软件包管理器记录

- Nix - migrate: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/mi/migrate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - python-migrate-doc - 0.13.0-0ubuntu2: installed executable or alias match | Ubuntu 24.04 LTS package indexes: python-migrate-doc from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Database schema migration for SQLAlchemy - doc | https://github.com/openstack/sqlalchemy-migrate
- Ubuntu apt - python3-migrate - 0.13.0-0ubuntu2: installed executable or alias match | Ubuntu 24.04 LTS package indexes: python3-migrate from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Database schema migration for SQLAlchemy - Python 3.x | https://github.com/openstack/sqlalchemy-migrate
- dnf - migrate - 4.19.1-5.fc45: installed executable or alias match | Fedora Rawhide package metadata: migrate from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Go database migrations library and program | https://github.com/golang-migrate/migrate
- Scoop - main/migrate: installed executable or alias match | Scoop official bucket manifest trees: bucket/migrate.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/golang-migrate.yml](https://github.com/mxcl/pkgdb/blob/main/combined/golang-migrate.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
