name: gui-tools description: 提供安装、配置和选择Git图形界面客户端(GitKraken、Sourcetree、GitHub Desktop)跨平台的指导。比较功能、许可和工作流。故障排除图形工具配置和设置问题。在安装Git图形客户端、设置Git可视化工具、配置图形提交工具、选择选项或故障排除配置时使用。覆盖Windows、macOS和Linux。所有工具都是可选的,基于用户偏好。 allowed-tools: Read, Bash, Glob, Grep
Git GUI工具
可选的Git图形用户界面工具。这些工具提供Git操作的视觉界面,使暂存更改、审查差异、管理分支和可视化仓库历史更容易。
概述
本技能帮助您:
- 为工作流选择正确的Git GUI工具
- 在Windows、macOS和Linux上安装流行的Git GUI客户端
- 正确配置GUI工具
- 理解许可和订阅要求
- 故障排除常见配置问题
重要:所有GUI工具都是可选的。它们补充命令行界面,但不是Git使用所必需的。许多开发者偏好仅使用命令行Git。
何时使用本技能
在以下情况使用本技能:
- 首次安装Git GUI客户端时
- 在GitKraken、Sourcetree、GitHub Desktop或其他工具之间选择时
- 安装后配置GUI工具时
- 故障排除GUI工具配置(如Sourcetree gitignore等)时
- 理解商业GUI工具的许可要求时
- 寻找平台特定的GUI推荐时
首次使用:检测和设置
在安装新GUI工具之前,检查系统上已安装的内容。
检查现有GUI工具:
# 检查是否安装GitKraken
which gitkraken # macOS/Linux
where.exe gitkraken # Windows PowerShell
# 检查是否安装Sourcetree
# Windows: 检查 "C:\Users\<user>\AppData\Local\SourceTree"
# macOS: 检查 "/Applications/Sourcetree.app"
test -d "/Applications/Sourcetree.app" && echo "Sourcetree已安装" || echo "未找到Sourcetree"
# 检查是否安装GitHub Desktop
which github-desktop # macOS/Linux(作为'github')
where.exe GitHubDesktop # Windows PowerShell
# 检查内置Git GUI工具(随Git提供)
git gui --version # Git GUI(Git内置)
gitk --version # gitk(内置仓库浏览器)
如果未安装GUI工具,请继续以下快速开始。
快速开始
Windows - 快速安装:
# GitKraken(跨平台,现代UI,私人仓库需要许可)
winget install --id Axosoft.GitKraken -e --source winget
# Sourcetree(免费,Atlassian,仅Windows/macOS)
winget install --id Atlassian.Sourcetree -e --source winget
# GitHub Desktop(免费,简单,专注于GitHub)
winget install --id GitHub.GitHubDesktop -e --source winget
# Fork(免费评估,快速现代)
winget install --id Fork.Fork -e --source winget
macOS - 快速安装:
# GitKraken(通过Homebrew Cask)
brew install --cask gitkraken
# Sourcetree(通过Homebrew Cask)
brew install --cask sourcetree
# GitHub Desktop(通过Homebrew Cask)
brew install --cask github
# Fork(通过Homebrew Cask)
brew install --cask fork
Linux - 快速安装:
# GitKraken(从网站下载.deb或.rpm)
# https://www.gitkraken.com/download
# GitHub Desktop(社区分支)
# https://github.com/shiftkey/desktop
# GitAhead(开源,轻量级)
# https://github.com/gitahead/gitahead
工具比较快速参考
| 工具 | 平台 | 许可 | 最佳适用 |
|---|---|---|---|
| GitKraken | Windows, macOS, Linux | 免费(公共仓库),专业版(私人) | 团队、视觉学习者、复杂工作流 |
| Sourcetree | Windows, macOS | 免费 | Atlassian用户、功能丰富的GUI |
| GitHub Desktop | Windows, macOS, Linux(分支) | 免费 | GitHub用户、简单性 |
| Fork | Windows, macOS | 免费(评估) | Sourcetree的现代替代 |
| Git GUI/gitk | 所有(随Git提供) | 免费(GPL) | 轻量级、无需安装 |
| GitAhead | Windows, macOS, Linux | 免费(MIT) | 轻量级、开源 |
📖 详细比较: 参见references/tool-comparison.md获取全面功能分析、许可详情和官方文档链接。
平台特定安装
各平台的详细安装说明,参见:
- Windows:references/windows-installation.md
- macOS:references/macos-installation.md
- Linux:references/linux-installation.md
内置工具(所有平台)
Git提供两个内置GUI工具:
- gitk - 仓库浏览器,用于可视化历史
- Git GUI - 提交工具,用于暂存更改
# 打开gitk(历史浏览器)
gitk --all
# 打开Git GUI(提交工具)
git gui
📖 详细用法: 参见references/built-in-tools.md获取命令、功能和用例。
选择正确工具
快速推荐:
- 初学者 → GitHub Desktop
- GitHub用户 → GitHub Desktop 或 GitKraken
- Bitbucket用户 → Sourcetree
- 高级用户 → Fork、Tower 或 SmartGit
- Linux用户 → GitAhead、SmartGit 或 内置工具
- 视觉学习者 → GitKraken
- 命令行纯粹主义者 → 无(或gitk用于快速可视化)
📖 详细指导: 参见references/choosing-right-tool.md获取全面决策标准。
安装后配置
安装GUI工具后:
- 配置Git身份(如果尚未完成)
- 添加SSH密钥(用于SSH克隆)
- 向Git托管提供商认证(GitHub、GitLab、Bitbucket)
- 配置差异/合并工具(可选)
📖 详细步骤: 参见references/configuration.md获取完整安装后配置。
故障排除
常见问题:
- GUI工具未检测到仓库 - 在设置中添加仓库目录
- 认证失败 - 检查凭据助手,刷新认证令牌
- 合并冲突未解决 - 配置合并工具或使用命令行
- 性能缓慢 - 启用Git性能功能,考虑Git LFS
📖 详细解决方案: 参见references/troubleshooting.md获取全面故障排除指导。
相关技能
- setup:基本Git安装和配置
- config:全面Git配置(凭据、性能、别名)
- line-endings:行尾配置和Git LFS
- gpg-signing:GPG提交签名设置
测试场景
场景1:工具安装
- 查询:“在Windows上安装GitKraken”
- 预期:提供winget命令和许可信息
场景2:工具选择指导
- 查询:“为Bitbucket选择Sourcetree和GitHub Desktop”
- 预期:根据比较表推荐Sourcetree并给出理由
场景3:故障排除
- 查询:“故障排除Sourcetree全局gitignore配置”
- 预期:提供故障排除部分的配置修复步骤
场景4:平台特定设置
- 查询:“在macOS上设置Fork”
- 预期:提供安装命令和许可说明
场景5:比较请求
- 查询:“比较所有Linux GUI选项”
- 预期:显示GitAhead、SmartGit和社区GitHub Desktop,列出优缺点
多模型测试笔记
测试状态:
| 模型 | 状态 | 测试日期 | 备注 |
|---|---|---|---|
| Claude Sonnet | ✅ 已验证 | 2025-11-25 | 技能正确激活,提供适当工具推荐和平台特定指导 |
| Claude Haiku | 🔄 待定 | — | 推荐测试:激活可靠性、简洁推荐 |
| Claude Opus | 🔄 待定 | — | 推荐测试:过度解释风险、跨平台复杂性 |
最后更新: 2025-11-28
参考
详细指南:
- references/tool-comparison.md - 全面工具比较矩阵
- references/built-in-tools.md - Git GUI和gitk用法
- references/choosing-right-tool.md - 按用例决策指导
- references/configuration.md - 安装后配置
- references/windows-installation.md - Windows安装指南
- references/macos-installation.md - macOS安装指南
- references/linux-installation.md - Linux安装指南
- references/troubleshooting.md - 故障排除常见问题
版本历史
- v1.0.0(2025-12-26):初始发布
💡 AI代理提示: 当帮助用户选择或安装Git GUI工具时,考虑使用可用的MCP服务器获取当前信息:
- 定价更新:使用
perplexityMCP,查询如“GitKraken 2025定价计划”或使用firecrawl直接获取定价页面- 许可更改:使用
refMCP检查官方供应商文档的许可更新- 平台可用性:使用
web_search验证特定平台或地区的工具可用性