Help us learn about your current experience with the documentation. Take the survey.

开始使用 Git

Git 是一个版本控制系统，用于跟踪代码更改并与他人协作。 GitLab 是一个基于 Web 的 Git 仓库管理器，提供 CI/CD 和其他功能，帮助您 管理软件开发生命周期。

您可以在不了解 Git 的情况下使用 GitLab。 但是，当您使用 GitLab 进行源代码控制时，了解 Git 会更有优势。

学习 Git 是更大工作流程的一部分：

Workflow

仓库

Git 仓库是一个包含项目所有文件、文件夹和版本历史的目录。 它充当中心枢纽，Git 在此管理和跟踪代码的更改。

当您初始化 Git 仓库或克隆现有仓库时，Git 会在项目目录中创建一个隐藏目录 .git。 该目录包含 Git 用于管理仓库的所有基本元数据和对象， 包括对文件所做的所有更改的完整历史记录。 Git 在文件级别跟踪更改，因此您可以随时间查看对单个文件所做的修改。

有关更多信息，请参阅 仓库。

工作目录

您的工作目录是您对代码进行更改的地方。 当您克隆 Git 仓库时，您会在工作目录中创建仓库的本地副本。 您可以编辑文件、添加新文件并测试代码。 为了协作，您可以：

  • 提交（Commit）：在工作目录中做出更改后，将这些更改提交到本地仓库。
  • 推送（Push）：将您的更改推送到 GitLab 托管的远程 Git 仓库。这使您的更改对其他团队成员可用。
  • 拉取（Pull）：从远程仓库拉取他人所做的更改，并确保您的本地仓库已更新为最新更改。

有关更多信息，请参阅 常用 Git 命令。

分支

在 Git 中，您可以使用分支同时处理不同的功能、错误修复或实验， 而不会相互干扰。 分支使您能够创建一个隔离的环境，您可以在其中进行更改和测试， 而不会影响默认分支。 在 GitLab 中，默认分支通常称为 main。

合并分支

功能完成或错误修复后，您可以将分支合并到默认分支。 您可以在 合并请求 中执行此操作。 合并是一种安全的方式，可以将一个分支的更改引入另一个分支，同时保留更改的历史记录。

如果分支之间存在冲突，例如，如果您在两个分支中都修改了相同的代码行， GitLab 会将这些标记为 合并冲突。 这些冲突必须通过审查和编辑代码手动解决。

删除分支

成功合并后，如果不再需要该分支，您可以删除它。 删除不必要的分支有助于保持仓库的组织性和可管理性。

为确保不会丢失任何工作，请在最终合并后删除分支之前， 验证所有更改都已合并到默认分支中。

有关更多信息，请参阅 分支。

了解 Git 工作流程

您可以使用 Git 工作流程管理代码、与他人协作并保持项目组织有序。 标准的 Git 工作流程包括以下步骤：

  1. 克隆仓库：通过将仓库克隆到您的机器上，创建本地副本。 您可以在不影响原始仓库的情况下处理项目。
  2. 创建新分支：在进行任何更改之前，建议创建一个新分支。 这确保您的更改是隔离的，不会干扰默认分支上其他人的工作。
  3. 进行更改：对工作目录中的文件进行更改。 您可以添加新功能、修复错误或进行其他修改。
  4. 暂存更改：对文件进行更改后，暂存您要提交的更改。 暂存告诉 Git 哪些更改应包含在下一次提交中。
  5. 提交更改：将暂存的更改提交到本地仓库。 提交保存您工作的快照，并创建文件更改的历史记录。
  6. 推送更改：与他人共享您的更改，将它们推送到远程仓库。 这使您的更改对其他协作者可用。
  7. 合并您的分支：在您的更改经过审查和批准后，将您的分支合并到 默认分支。例如，main。此步骤将您的更改合并到项目中。

Fork（分支）

一些组织，特别是那些从事开源项目的组织，可能会使用 不同的工作流程。例如，Fork。

Fork 是存在于您自己命名空间中的仓库的个人副本。 在为开源项目做贡献或您的团队使用集中式仓库时，使用此工作流程。

安装 Git

要使用 Git 命令并为 GitLab 项目做贡献，您应该下载并安装 Git 客户端到您的计算机上。

安装过程因操作系统而异。 例如，Windows、MacOS 或 Linux。 有关如何安装 Git 的信息，请参阅 安装 Git。

Git 命令

要从命令行与 Git 交互，您可以使用 Git 命令：

  • git clone：将仓库克隆到您的本地机器。
  • git branch：列出、创建或删除本地仓库中的分支。
  • git checkout：在本地仓库中的不同分支之间切换。
  • git add：为提交暂存更改。
  • git commit：将暂存的更改提交到本地仓库。
  • git push：将本地提交推送到远程仓库。
  • git pull：从远程仓库获取更改并将其合并到您的本地分支。

有关更全面的信息和详细解释， 请参阅 Git 命令指南。

使用 Git 实践

学习 Git 的最佳方法是实践。 您可以创建一个测试项目，尝试不同的 Git 命令， 并探索不同的工作流程。

GitLab 为许多 Git 操作提供了基于 Web 的界面，但您也可以使用 命令行中的 Git 与 GitLab 交互。这为您提供了额外的 灵活性和控制权。

有关学习 Git 命令的实践方法，请参阅 教程：进行您的第一次 Git 提交。 有关其他有用的资源，请参阅 教程：学习 Git。