1. 理解基本概念：Git 服务器 vs. 托管服务
2. 选择你的 Git 服务器方案
3. 在 Eclipse 中配置 Git
4. 克隆、提交、推送和拉取操作
5. 团队协作工作流

基本概念：Git 服务器 vs. 托管服务

在开始之前,需要明确一个重要概念：

• Git 服务器：通常指你自己搭建和维护的 Git 仓库服务器，它可以是公司内网的一台 Linux 机器，也可以是你自己的云服务器，你需要自己负责服务器的安装、配置、备份和安全，常用的自建服务器软件有 GitLab、Gitea、Gogs 或纯 Git (使用 git-daemon 或 SSH)。
• Git 托管服务：这是由第三方公司提供的在线 Git 仓库服务，你无需关心服务器维护，只需注册账号，创建仓库即可，最著名的是 GitHub、Gitee (码云) 和 GitLab.com，对于个人开发者和小型团队来说，这是最简单、最常用的选择。

对于 Eclipse 无论你使用哪种服务器，Eclipse 内置的 EGit 插件（Git 客户端）的操作方式都是基本相同的。 我们将主要围绕 GitHub (托管服务) 和 GitLab (自建服务器) 这两种最常见的情况来讲解。

选择你的 Git 服务器方案

根据你的需求选择一种：

使用 Git 托管服务 (推荐新手)

优点：

• 开箱即用：注册账号即可创建仓库。
• 无需维护：不用担心服务器宕机、备份等问题。
• 强大的 Web 界面：方便代码审查、问题跟踪、CI/CD 集成。
• 社交功能：可以方便地参与开源项目。

主流选择：

• GitHub: 全球最大,开源项目首选。
• Gitee (码云)：国内访问速度快，对开源项目免费,与国内开发者社区联系紧密。
• GitLab.com: GitLab 官方提供的云服务,功能强大。

自建 Git 服务器

优点：

• 数据完全私有：所有代码都在自己的控制之下,安全性更高。
• 高度定制化：可以根据公司需求集成内部系统、定制权限等。
• 无流量限制：不用担心外部服务器的 API 调用或存储限制。
• 成本可控：如果已有服务器,边际成本较低。

主流选择：

• GitLab: 功能最全面，集成了项目管理、CI/CD、Wiki 等,是自建服务器的首选。
• Gitea/Gogs: 轻量级，安装简单，资源占用少,适合中小型团队。
• 纯 Git + SSH: 最原始的方式，配置最灵活,但功能最少。

在 Eclipse 中配置 Git

Eclipse 自带了 EGit 插件，所以你不需要额外安装,只需进行一些初始配置。

步骤 1: 配置 Git 用户信息

这个信息会用于标记你的每一次代码提交。

1. 打开 Eclipse，进入菜单 Window -> Preferences。
2. 在左侧导航栏中，找到并展开 Team -> Git -> Configuration。
3. 在右侧的 "Global Configuration" (全局配置) 部分，设置你的用户名和邮箱。
   • 点击 Add Entry 按钮。
   • Key: user.name
   • Value: 你的名字 ( Zhang San)
   • 再次点击 Add Entry。
   • Key: user.email
   • Value: 你的邮箱 ( zhangsan@example.com)
4. 点击 Apply and Close。

步骤 2: 连接到你的 Git 服务器

对于 GitHub/Gitee 等托管服务：

通常你只需要在网站上注册账号即可，Eclipse 在克隆或推送时会通过 HTTPS 或 SSH 协议与它们通信。

对于自建 GitLab/Gitea 服务器：

如果你的服务器使用 SSH 协议（推荐），你需要配置 SSH 密钥，以便 Eclipse 可以免密登录。

1. 生成 SSH 密钥：

   • 打开你的操作系统终端 (Windows 上可以使用 Git Bash)。
   • 输入命令：ssh-keygen -t ed25519 -C "your_email@example.com"
   • 一路按回车即可，默认会在用户主目录的 .ssh 文件夹下生成 id_ed25519 (私钥) 和 id_ed25519.pub (公钥) 文件。

2. 将公钥添加到 Git 服务器：

   • 登录你的自建 GitLab/Gitea 服务器。
   • 进入你的个人账户设置 (Account Settings / SSH Keys)。
   • 复制 id_ed25519.pub 文件中的全部内容，粘贴到 "SSH Key" 文本框中,并给密钥起个名字。
   • 保存。

3. 验证连接：

   • 在终端中输入 ssh -T git@your_server_ip (ssh -T git@gitlab.mycompany.com)。
   • 如果看到欢迎信息,说明连接成功。

克隆、提交、推送和拉取操作

这是日常开发中最核心的 Git 操作。

从服务器克隆一个新项目

假设你已经在 GitHub 上创建了一个名为 my-awesome-project 的仓库。

1. 在 GitHub 仓库页面上，点击 "Code" 按钮，然后复制仓库的 URL。

   • HTTPS URL: https://github.com/your-username/my-awesome-project.git
   • SSH URL: git@github.com:your-username/my-awesome-project.git (推荐,更安全且无需每次输入密码)

2. 在 Eclipse 中，进入菜单 File -> Import。

3. 展开 Git 文件夹，选择 Projects from Git，然后点击 Next。

4. 选择 Clone URI，然后点击 Next。

5. 在 "Source Git Repository" 页面，粘贴你刚才复制的 URL，Eclipse 通常会自动识别协议和主机，点击 Next。

6. 在 "Remote References" 页面，选择要克隆的分支 (通常是 main 或 master)，点击 Next。

7. 在 "Local Destination" 页面，选择一个本地文件夹来存放项目代码，点击 Next。

8. 在 "Import Projects" 页面，选择要导入的工作空间，然后点击 Finish。

Eclipse 会开始下载代码,并将其作为项目导入到你的工作空间中。

修改代码并提交

1. 在 Eclipse 中修改你的项目文件。
2. 保存文件后，你会发现项目图标上出现了蓝色的感叹号或 M 标记,表示文件已被修改。
3. 在 Eclipse 的 "Git Staging" 视图中 (通常在右下角，如果没有可以打开 Window -> Show View -> Other... -> Git -> Staging)：
   • 你会看到所有修改的文件。
   • Staged (暂存区)：点击文件名左侧的 号，将文件从 "Unstaged" 移动到 "Staged",这意味着你准备好将这些修改纳入下一次提交。
   • Commit (提交)：
     • 在下方的 "Commit Message" 输入框中，写一个清晰的提交信息，"Fix login bug"。
     • 点击 Commit 按钮，这会将暂存区的修改保存到你的本地仓库中,你的修改还没有上传到服务器。

推送到远程服务器

当你完成了一组相关的提交后，需要将它们推送到远程服务器,以便团队成员可以看到你的更新。

1. 在 "Git Staging" 视图中，点击工具栏上的 Push 按钮。
2. 在弹出的 "Push" 对话框中，确认你要推送的分支 (通常是 refs/heads/main)。
3. 如果你的远程仓库是 HTTPS，Eclipse 可能会提示你输入用户名和密码，如果是 SSH,它应该会直接使用你配置的密钥进行认证。
4. 点击 Finish,你的提交现在就在服务器上了！

从服务器拉取更新

当其他团队成员向服务器推送了新代码后，你需要将这些更新拉取到本地,以保持你的代码是最新的。

1. 在 "Git Staging" 视图中，点击工具栏上的 Pull 按钮。
2. Eclipse 会从远程仓库获取最新的代码，并尝试与你的本地代码进行合并。
3. 如果没有冲突，操作会顺利完成，如果有冲突，Eclipse 会提示你解决。

团队协作工作流

一个简单的团队协作流程如下：

1. 创建分支：不要直接在 main 分支上开发，为了修复一个 bug 或开发一个新功能，你应该从 main 分支创建一个新的功能分支。

   • 在 "Git Repositories" 视图中，右键点击 main 分支 -> Checkout。
   • 然后右键点击项目 -> Team -> Switch To -> New Branch...，命名为 feature/user-login。

2. 在分支上开发：所有相关的修改都在这个新分支上进行，修改 -> 暂存 -> 提交。

3. 推送分支：将你的功能分支推送到服务器。

   • 在 "Git Staging" 视图中点击 Push。
   • 在 Push 对话框中，确保选择的是你的新分支 refs/heads/feature/user-login。
   • 推送成功后,你的远程仓库上就有了这个分支。

4. 创建合并请求 / 拉取请求：

   • 登录你的 Git 服务器 (GitHub/GitLab)。
   • 在你的仓库页面，你会看到一个提示,告诉你有一个新的分支可以合并。
   • 点击 "New Pull Request" (GitHub) 或 "New Merge Request" (GitLab)。
   • 选择源分支 (feature/user-login) 和目标分支 (main)。
   • 和描述,解释你的修改内容。
   • 提交请求,你的团队成员可以在这里进行代码审查和讨论。

5. 合并：

   • 代码审查通过后，仓库管理员或你本人可以在网页上点击 "Merge" 按钮。
   • 你的功能分支就会被合并到 main 分支。

6. 清理和同步：

   • 在本地，切换回 main 分支 (git checkout main)。
   • 执行 Pull 操作，确保 main 分支是最新版本。
   • 删除本地的功能分支 (git branch -d feature/user-login) 和远程的功能分支 (在 GitLab/GitHub 网页上删除)。

掌握以上流程，你就可以在 Eclipse 中高效地使用 Git 与你的服务器进行交互了，对于初学者，强烈建议从使用 GitHub 或 Gitee 这样的托管服务开始,因为它们极大地简化了服务器的管理。