git-format-staged for Mac 版
使用格式化命令转换已暂存文件的 Git 命令
git-format-staged 是什么
git-format-staged 是一个配合 Git 使用的格式化工具,专门解决提交前自动格式化代码时的一个常见痛点:传统做法会把整个文件重新暂存,导致开发者无意中提交未打算提交的改动,也破坏了 `git add -p` 的精细暂存流程。
它的做法是把格式化器直接作用在文件的暂存版本上——也就是 Git 对象库里那份已暂存的内容,而不是工作区的文件。格式化结果直接替换索引中的内容,整个过程绕过工作区,因此未暂存的改动不会被格式化器碰到,也不会被意外暂存。格式化完成后,它会计算一个补丁并尝试应用到工作区文件,让工作区与暂存内容保持同步;如果补丁失败会给出警告,但提交的版本仍是正确格式化的,只是工作区副本保持原样。这个同步步骤可以用 `--no-update-working-tree` 关闭。
适合希望在项目中统一代码风格、又不想牺牲暂存精细度的团队和开发者,常与 husky 等钩子工具搭配,在 pre-commit 阶段调用 prettier 之类的格式化命令。支持通过 Nix、npm、Homebrew 安装,也可直接复制脚本使用,要求 Python 3.8 及以上。
它的做法是把格式化器直接作用在文件的暂存版本上——也就是 Git 对象库里那份已暂存的内容,而不是工作区的文件。格式化结果直接替换索引中的内容,整个过程绕过工作区,因此未暂存的改动不会被格式化器碰到,也不会被意外暂存。格式化完成后,它会计算一个补丁并尝试应用到工作区文件,让工作区与暂存内容保持同步;如果补丁失败会给出警告,但提交的版本仍是正确格式化的,只是工作区副本保持原样。这个同步步骤可以用 `--no-update-working-tree` 关闭。
适合希望在项目中统一代码风格、又不想牺牲暂存精细度的团队和开发者,常与 husky 等钩子工具搭配,在 pre-commit 阶段调用 prettier 之类的格式化命令。支持通过 Nix、npm、Homebrew 安装,也可直接复制脚本使用,要求 Python 3.8 及以上。
如何安装 git-format-staged
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-08-03,当前版本 v4.0.2,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v4.0.2 | 2026-08-03 | 稳定版 | — | — | — | — |
| v3.1.3 | 2026-01-04 | 稳定版 | — | — | — | — |
| v4.0.1 | 2026-01-04 | 稳定版 | — | — | — | — |
| v4.0.0 | 2025-12-31 | 稳定版 | — | — | — | — |
| v3.1.2 | 2025-12-30 | 稳定版 | — | — | — | — |
| v3.1.1 | 2024-02-27 | 稳定版 | — | — | — | — |
| v3.1.0 | 2024-02-25 | 稳定版 | — | — | — | — |
| v3.0.0 | 2022-03-20 | 稳定版 | — | — | — | — |
| v2.1.3 | 2021-12-14 | 稳定版 | — | — | — | — |
| v2.1.2 | 2021-06-10 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- all
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| git-format-staged | v4.0.2 | MIT | 命令行 | 1,491 |
| git-pkgs | v0.22.0 | MIT | 命令行 | 1,787 |
| swift-format | 604.0.0 | Apache-2.0 | 命令行 | 2,220 |
| dolt | v2.7.3 | Apache-2.0 | 命令行 | 5,010 |