【亲测免费】 SourceGit 安装和配置指南

1. 项目基础介绍和主要编程语言

SourceGit 是一个跨平台的 Git GUI 客户端，支持 Windows、macOS 和 Linux 操作系统。该项目的主要目的是为 Git 用户提供一个图形化界面，简化 Git 操作流程。SourceGit 的主要编程语言是 C#，它利用了 .NET 框架来构建跨平台的应用程序。

2. 项目使用的关键技术和框架

关键技术

• Git: SourceGit 是一个 Git 客户端，因此 Git 是该项目的基础技术。用户可以通过 SourceGit 执行所有常见的 Git 操作，如克隆、拉取、推送、合并、重置等。
• SSH: SourceGit 支持通过 SSH 访问远程仓库，确保数据传输的安全性。
• Git LFS: 支持 Git 大文件存储（LFS），方便管理大型文件。
• GitFlow: 内置 GitFlow 支持，帮助用户更好地管理分支和版本。

框架

• Avalonia UI: SourceGit 使用 Avalonia UI 框架来构建跨平台的图形用户界面。Avalonia 是一个基于 .NET 的多平台 UI 框架，支持 Windows、macOS 和 Linux。
• OpenAI: SourceGit 集成了 OpenAI 或其他兼容的 AI 服务，用于自动生成提交消息。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. 安装 Git: 在使用 SourceGit 之前，确保你已经安装了 Git（版本 >= 2.23.0）。你可以从 Git 官方网站下载并安装最新版本的 Git。
2. 安装依赖工具: 根据你的操作系统，安装必要的依赖工具，如 git-credential-manager 和 xdg-open（仅限 Linux）。

详细安装步骤

Windows 用户

1. 下载 SourceGit: 你可以从 SourceGit 的 GitHub 发布页面下载最新版本的安装包。
2. 安装 SourceGit: 运行下载的安装包，按照提示完成安装。
3. 首次运行: 首次运行时，你可能需要从命令行或通过 Win+R 启动 SourceGit。之后，你可以将其固定到任务栏。
4. 配置外部编辑器: 如果你使用的是便携版本的编辑器（如 Visual Studio Code），可以在应用数据目录中创建 external_editors.json 文件，并手动指定编辑器路径。

macOS 用户

1. 下载 SourceGit: 从 SourceGit 的 GitHub 发布页面下载适用于 macOS 的安装包（sourcegit_x.y.osx-x64.zip 或 sourcegit_x.y.osx-arm64.zip）。
2. 安装 SourceGit: 解压下载的文件，并将 SourceGit.app 移动到 Applications 文件夹。
3. 信任软件: 确保你的 Mac 信任所有来源的软件。你可以通过运行 spctl --master-disable 来实现这一点。
4. 首次运行: 你可能需要从命令行启动 SourceGit，使用 open -a SourceGit 命令。

Linux 用户

1. 下载 SourceGit: 从 SourceGit 的 GitHub 发布页面下载适用于 Linux 的安装包。
2. 安装 SourceGit: 解压下载的文件，并运行 SourceGit 可执行文件。
3. 安装依赖: 确保安装了 xdg-open 和 git-credential-manager。
4. 配置 DPI: 你可能需要设置环境变量 AVALONIA_SCREEN_SCALE_FACTORS 来配置屏幕 DPI。

配置 AI 服务

1. 打开偏好设置: 在 SourceGit 中打开偏好设置窗口。
2. 配置 AI 服务: 如果你使用 OpenAI，服务器地址应为 https://api.openai.com/v1/chat/completions。如果你使用其他 AI 服务，请填写相应的 URL。
3. API 密钥: 根据服务要求，填写 API 密钥（可选）。

通过以上步骤，你就可以成功安装并配置 SourceGit，开始使用这个强大的 Git GUI 客户端了。