【亲测免费】 SourceGit 技术文档

SourceGit 是一个开源的 Git 图形界面客户端，旨在提供快速、高效的版本控制体验，支持多平台操作，包括 Windows、macOS 和 Linux。此文档将引导您完成安装流程，学习基本使用方法，并简介其 API 使用和配置细节。

安装指南

Windows 用户

1. 先决条件: 确保已安装 Git（版本 >=2.23.0）。推荐使用 Git for Windows。
2. 安装稳定版：
   • 使用 winget: 运行命令 winget install SourceGit。
   • 或通过 scoop: 添加额外存储库 (scoop bucket add extras) 后，运行 scoop install sourcegit。
   • 对于便携版，从 最新版本页面 下载并解压。
3. 初次运行: 首次需要通过命令行（如按 Win+R 输入 SourceGit）启动或添加到任务栏。

macOS 用户

1. 从 Releases 下载适合您的架构（Intel 或 arm64）的 .zip 文件。
2. 解压缩并将 SourceGit.app 移至 /Applications 目录。
3. 允许任意来源的应用程序执行（在终端运行 spctl --master-disable）。
4. 安装 git-credential-manager。
5. 如遇到权限问题，可能需要运行 sudo xattr -cr /Applications/SourceGit.app。

Linux 用户

1. 检查是否已安装 Git，且确认有 xdg-open 支持。
2. 安装 git-credential-manager 并设置环境变量 AVALONIA_SCREEN_SCALE_FACTORS 若有必要。
3. 下载适用于您的发行版的 .tar.gz 包，解压后运行可执行文件。

项目的使用说明

SourceGit 提供直观的图形界面来执行常见的 Git 命令：

• 基本操作: 克隆(Clone)、拉取(Fetch)、推送(Push)等。
• 高级操作: 分支管理、合并(Merge)、重置(Reset)、变基(Rebase)等。
• 可视化工具: 详细分支视图、视觉化的提交图(Commit Graph)。
• 特色功能: 支持 GitFlow 工作流、Git LFS、问题链接等。
• 主题定制: 内置亮暗模式，支持自定义主题。

用户设置和数据存放在特定路径下，根据操作系统不同而异，详情见项目 README。

项目API使用文档

SourceGit作为一个GUI应用，不直接对外公开API接口以供编程调用。但它的功能丰富，支持脚本调用和外部工具集成，例如通过设置环境变量来指定外部编辑器或IDE的路径，实现集成开发环境的无缝对接。

项目配置与安装方式

所有用户的配置信息保存在特定于平台的目录内，无需手动配置API使用；安装主要通过下载预编译的软件包或利用包管理工具进行。对于开发者或想深入定制的用户，可以查看源码进行二次开发或贡献代码到项目中，遵循其贡献指南，基于 develop 分支创建PR。

---

SourceGit的设计理念在于简化Git命令的复杂性，为用户提供友好、高效的工作环境。通过本文档，希望能帮助您快速上手并熟练运用SourceGit，无论是日常的版本控制还是复杂的Git工作流管理。