如果你是一名 macOS 开发者，日常 Git 操作是否总是在终端和 IDE 之间来回切换？是否觉得每次 commit、pull、push 都要打开终端输入命令有些繁琐？今天给大家介绍一款开源工具——PanghuGit，它将 20+ Git 操作直接集成到 macOS Finder 右键菜单中，让你像操作文件一样操作 Git。
项目简介
PanghuGit 是一款原生 macOS 应用，通过 Finder Sync Extension 将 Git 操作无缝嵌入 Finder 右键菜单。无需打开终端或任何 Git GUI，只需在 Finder 中右键点击任意目录，即可看到 PanghuGit 子菜单，一键完成日常 Git 操作。
- GitHub 仓库：https://github.com/lucycoding/PanghuGit
- Gitee 仓库：https://gitee.com/lucycoding/PanghuGit
- 许可证：MIT License
- 系统要求：macOS 13.0 (Ventura) 及以上
- 语言：Swift / SwiftUI，纯原生无第三方依赖
本项目完全由 VibeCoding 生成，作者未手写一行代码，依托于opencode go套餐及其他模型厂商的订阅（如讯飞星火codingplan、火山方舟codingplan、腾讯codebuddy等）完成项目代码开发。
核心功能一览
1. 提交与同步
Commit 视图支持 Conventional Commits 快捷选择（feat/fix/docs 等 8+ 类型），作者自动补全，Hunk 级别暂存——你可以只暂存文件中的部分修改，而非整个文件。
Sync 视图集成了 Pull / Push / Fetch，一键同步远程仓库。
2. 日志与差异
Log 视图采用渐进式加载（默认加载 7 天，点击加载更多追加 50 条），左侧边栏展示本地和远程分支列表，支持按分支筛选、多选 Cherry-pick。
Diff 视图提供语法高亮：新增行绿色、删除行红色、文件头紫色、Hunk 头蓝色，一目了然。
3. 分支管理
支持分支切换、创建、删除、重命名、从指定 Commit 创建分支，以及 Merge / Rebase 操作。
4. 冲突解决
内置三列冲突解决视图（Ours / Base / Theirs），支持按块选择、手动编辑模式，还可集成 FileMerge 进行可视化对比。
5. Stash 与 Tag
Stash 视图支持逐文件浏览、--keep-index 选项、从 Stash 创建分支。Tag 视图支持创建、删除、查看标签详情。
6. 高级操作
PanghuGit 还提供了丰富的高级 Git 操作：
| 功能 | 说明 |
|---|---|
| Git Blame | 面包屑导航 + 跳转上一版本 |
| Submodule | 批量同步/更新 |
| Worktree | 多工作树管理 |
| Patch | 创建/应用/预览/Dry Run |
| Export | git archive 导出 |
| Cleanup | 清理未跟踪文件 |
| Bisect | Good/Bad/Skip + 输出解析 |
| Reflog | 引用日志查看 |
7. 文件状态徽章
PanghuGit 会在 Finder 中自动为文件显示状态徽章（修改/新增/删除/未跟踪/冲突/忽略），使用 macOS 原生 SF Symbols，让你一眼就能看到哪些文件有变动。
个性化设置
PanghuGit 提供了丰富的设置选项：
- 通用设置：菜单风格（子菜单/平铺模式）、默认终端（Terminal / iTerm2 / Warp）
- Git 设置：Git 路径四级回退（用户指定 → PATH → /usr/bin/git → 内置 git）
- 语言设置：中英文一键切换
- 提交设置：Conventional Commits 模板自定义
键盘快捷键
全键盘操作支持，高效开发：
| 快捷键 | 功能 |
|---|---|
Cmd+Return |
提交 |
Cmd+Shift+Return |
提交并推送 |
Cmd+Shift+S |
暂存 |
Cmd+Option+S |
取消暂存 |
Cmd+R |
刷新 |
Cmd+C |
复制 SHA |
Cmd+P |
拉取 |
CLI 命令行模式
除了 GUI，PanghuGit 还提供了 panghugit CLI 工具，支持 zsh 和 bash Tab 补全：
panghugit version # 查看版本
panghugit which <path> # 查看仓库根路径
panghugit branch <path> # 列出分支
panghugit log <path> [options] # 查看提交历史
panghugit diff <path> [options] # 查看差异
panghugit show <path> <ref> # 查看提交详情
panghugit open <action> <path> # 打开 GUI
安装方式
Homebrew Cask（推荐）
brew tap lucycoding/tap
brew install --cask panghugit
Homebrew Formula（源码编译）
brew tap lucycoding/tap
brew install panghugit
DMG 直接下载
前往 GitHub Releases 下载最新 DMG 安装包。
技术架构
PanghuGit 采用双进程架构：
- Finder Sync Extension（沙盒）—— 运行在 Finder 进程内，提供右键菜单和文件状态徽章
- Main App（非沙盒）—— 接收 URL Scheme 事件，路由到对应 SwiftUI 视图，执行 Git 操作
进程间通信通过三种机制实现：
– panghugit:// URL Scheme（Extension → Main App）
– App Group UserDefaults（共享设置）
– DistributedNotificationCenter（跨进程通知）
项目拥有 163 个单元测试，CI 通过 GitHub Actions 自动构建和测试，Release 流程自动打包 DMG 并发布到 GitHub。
为什么选择 PanghuGit？
- 零学习成本：右键即用，无需记忆命令
- 原生体验：纯 SwiftUI 构建，与 macOS 风格完美融合
- 功能全面：20+ Git 操作覆盖日常开发全场景
- 双语支持：中英文界面一键切换
- 开源免费：MIT 许可证，代码完全开放
如果你也想让 Git 操作更高效、更优雅，欢迎 Star、Fork 和贡献代码！项目地址：GitHub | Gitee