# 使用 Homebrew, apk, dnf, MacPorts, Nix, scoop, winget 安装 hatch

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

## 安装

```sh
sudo av install brew:hatch
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install hatch
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install hatch
```

  证据: MacPorts ports tree: python/hatch/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add hatch
```

  证据: Alpine Linux edge package indexes: hatch from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install hatch
```

  证据: Fedora Rawhide package metadata: hatch 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#hatch
```

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

### Windows

- Scoop (92%):

```sh
scoop install main/hatch
```

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

- winget (92%):

```sh
winget install --id PyPA.Hatch -e
```

  证据: Windows Package Manager source index: PyPA.Hatch from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:hatch
- **软件包管理器:** Homebrew
- **版本:** 1.17.1
- **来源摘要:** Modern, extensible Python project management
- **主页:** <https://hatch.pypa.io/latest/>
- **最后更新:** 2026-07-09T03:33:21Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- hatch (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

Hatch is a modern, extensible Python project manager under the PyPA organization. It packages project creation, build backend integration, environment management, testing, static analysis, versioning, publishing, Python distribution management, and script running behind one CLI.

Its history is tied to Python's move toward pyproject.toml-centered packaging. Hatch and Hatchling give package authors a standards-compliant build backend plus a workflow tool, making it a notable entry in the post-setup.py packaging era.

### 项目历史

The Hatch history page records version 1.0.0 on 2022-04-28 as the first stable release of Hatch v1 and a complete rewrite. The adjacent Hatchling history records 0.24.0 on the same date as the initial public release of the Hatchling build system, establishing the split between the user-facing Hatch CLI and the build backend.

The 1.1.0 history entry says project metadata was updated to reflect adoption by PyPA and production stability. That matters historically because PyPA ownership placed Hatch among the packaging tools documented and maintained in the Python packaging ecosystem rather than as only an individual project.

Later history entries show Hatch broadening from packaging and environments into batteries-included project operations: publishing confirmation and index plugins, virtual-environment storage and plugin APIs, automatic Python distribution downloads, test commands, static analysis defaults, standalone binaries through PyApp, UV support, dependency groups, workspaces, and PEP 751 lockfile commands.

### 采用历史

Hatch adoption came from Python projects that wanted a single pyproject.toml-native workflow for building, testing, versioning, environment scripts, and publishing. Its README presents standardized builds, reproducible builds by default, environment management, Python management, test execution, static analysis, script running, publishing, version management, and project generation as first-class features.

The build documentation emphasizes that Hatch complies with modern Python packaging specifications and that other tools can consume projects using Hatch as a build backend. This is central to adoption: projects can use Hatchling while still interoperating with pip, tox, cibuildwheel, PyPI, and other packaging tools.

Package-manager adoption reflects that dual role. Homebrew and other OS package managers distribute the hatch CLI, while Python packaging itself consumes Hatchling through build-system requirements in pyproject.toml.

### 使用方式

Typical CLI workflows include hatch new, hatch build, hatch publish, hatch version, hatch run, hatch env commands, hatch test, and Hatch-managed Python or environment operations. Configuration lives in user config files plus pyproject.toml or hatch.toml project tables.

As a build backend, Hatchling is declared in pyproject.toml with build-system.requires and build-backend. As a workflow manager, Hatch creates and runs named environments, executes scripts, builds distributions, and coordinates publishing without forcing all projects to abandon other tools in the packaging ecosystem.

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

Hatch is significant because it bundles several trends in Python packaging: pyproject.toml configuration, backend/front-end separation, reproducible builds, environment automation, plugin hooks, and standards-based metadata. It is not just a build backend and not just a virtualenv wrapper.

For package nerds, Hatchling's small build-backend role is as important as the hatch CLI. A project can depend on Hatchling for wheel and sdist creation while developers use Hatch for environments, scripts, tests, versions, and publishing.

The changelog also tracks the moving Python packaging target: Python version support drops, metadata version updates, SBOM support, dependency groups, UV integration, lockfiles, PyPI telemetry user agents, and workspace concepts all appear as the ecosystem evolves.

### 时间线

- 2022-04-28: Hatch 1.0.0 shipped as the first stable v1 release and complete rewrite; Hatchling 0.24.0 shipped as the initial public build-system release.
- 2022-05-12: Hatch 1.1.0 updated project metadata to reflect PyPA adoption and production stability.
- 2023: Hatch added and refined publishing, virtual environment behavior, build backend flexibility, automatic Python downloads, and plugin interfaces.
- 2024: Hatch added a test command, UV support for virtual environments, official GitHub Action support, and Python distribution source controls.
- 2025: Hatch 1.16.0 added workspace support inspired by Cargo Workspaces and dependency group support.
- 2026: Hatch 1.17.0 added check commands, PEP 751 lockfile generation, dependency lock/sync commands, and pluggable dependency lockers.

### Related projects

- Hatchling is Hatch's build backend and is declared by projects through pyproject.toml.
- PyPA is the Python Packaging Authority organization under which Hatch is maintained.
- PyPI, pip, tox, cibuildwheel, virtualenv, UV, Ruff, PyApp, and Python packaging standards are recurring integration points in Hatch documentation and history.

### 来源

- <https://formulae.brew.sh/formula/hatch>
- <https://github.com/pypa/hatch>
- <https://hatch.pypa.io/>
- <https://hatch.pypa.io/1.12/history/hatchling/>
- <https://hatch.pypa.io/1.16/build/>
- <https://hatch.pypa.io/1.16/why/>
- <https://hatch.pypa.io/dev/history/hatch/>


## 安全说明

没有找到 hatch 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- macOS: ~/Library/Application Support/hatch/config.toml
- Unix: $XDG_CONFIG_HOME/hatch/config.toml, ~/.config/hatch/config.toml
- Windows: %USERPROFILE%\AppData\Local\hatch\config.toml
## 其他软件包管理器记录

- Nix - hatch: normalized package name match | nixpkgs package indexes: pkgs/by-name/ha/hatch/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - hatch - 1.16.3-r1: normalized package name match | Alpine Linux edge package indexes: hatch from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Modern, extensible Python project management | https://hatch.pypa.io/latest/
- apk - hatch-pyc - 1.16.3-r1: normalized package name match | Alpine Linux edge package indexes: hatch-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for hatch | https://hatch.pypa.io/latest/
- dnf - hatch - 1.17.1-2.fc45: normalized package name match | Fedora Rawhide package metadata: hatch from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | A modern project, package, and virtual env manager | https://github.com/pypa/hatch
- MacPorts - hatch: normalized package name match | MacPorts ports tree: python/hatch/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/hatch: normalized package name match | Scoop official bucket manifest trees: bucket/hatch.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - PyPA.Hatch: normalized package name match | Windows Package Manager source index: PyPA.Hatch from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

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


## 来源

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