• Git 术语
  • 仓库
  • 派生
  • 下载和克隆之间的不同
  • 拉取和推送
• 先决条件
  • 打开一个终端
  • 安装 Git
  • 配置 Git
  • 选择一个仓库
• 克隆一个仓库
  • 用 SSH 进行克隆
  • 用 HTTPS 进行克隆
  • 将本地目录转换成仓库
    • 添加一个远端
    • 查看远程仓库
  • 下载项目中的最新更改
• 分支
  • 创建一个分支
  • 切换分支
  • 查看差异
  • 查看更改的文件
  • 添加并提交本地更改
    • 准备并提交所有更改
  • 将更改推送到远端
  • 删除分支中的所有更改
  • 取消已添加到暂存区的所有更改
  • 撤销最近的提交
  • 将一个分支与默认分支合并
• Git 使用命令行的高级用法
• 将派生仓库中的更改与上游同步

在命令行开始使用 Git

Git 是一个开源的分布式版本控制系统，极狐GitLab 是建立在 Git 之上。

您可以在极狐GitLab 中直接执行很多 Git 操作。但是，高级任务是需要命令行操作的，比如修复复杂的合并冲突或回滚提交。

有关使用 Git 和 GitLab 的优势的更多信息:

为了帮助您去可视化您在本地所做的事情，您可以安装一个 Git GUI app。

Git 术语

如果您熟悉 Git 术语，您可以跳过本节，直接查看先决条件部分。

仓库

在极狐GitLab 中, 文件被存放在仓库，一个仓库类似于将文件存储在计算机的文件夹或目录中。

• 一个 远端仓库 指的是在极狐GitLab 中的文件。
• 一个 本地副本 指的是在您电脑上的文件。

通常，“repository” 这个词会被缩写为 “repo”。

在极狐Gitlab 中，仓库 包含在 项目 之中。

派生

当您希望向其他人的仓库中贡献内容时，您可以复制它。 这种复制称作派生。这个过程叫做 “创建一个派生。”

当您派生一个仓库，就会在您个人的命名空间下创建一个项目的副本，您就拥有了修改项目文件的写权限和设置。

例如, 您可以派生这个项目 https://gitlab.cn/gitlab-tests/sample-project/ 到您的命名空间下,

现在，您拥有了自己的仓库副本。

您可以在URL中查看命名空间, 如: https://gitlab.cn/your-namespace/sample-project/，

随后，您可以将仓库克隆到本地机器上，处理文件，并将更改提交回原始的仓库。

下载和克隆之间的不同

在计算机上创建远程仓库文件的副本， 您可以下载或者克隆这个仓库，如果您是通过下载的, 那么您无法将仓库与极狐GitLab 上的远程仓库同步。

克隆仓库与下载仓库相同，只是它保留了与远程仓库的 Git 连接。然后，您可以在本地修改文件并将更改上传到极狐GitLab 上的远程仓库。

拉取和推送

保存仓库的本地副本并修改计算机上的文件后，您可以将更改上传到极狐GitLab。这被称为推送到远程，使用命令git push。

当远程仓库发生更改时，您的本地副本就滞后了，您可以使用远程仓库中的新更改来更新本地副本。这被称作从远程拉取 ，使用命令git pull。

先决条件

在开始使用 Git 和极狐GitLab 前，请完成以下任务:

• 创建并登录到一个极狐GitLab 账号；
• 打开一个终端；
• 在您的计算机上安装 Git ；
• 配置 Git；
• 选择一个仓库。

打开一个终端

要在计算机上执行 Git 命令，必须打开终端（也称为命令提示符、命令 shell 和命令行）。这里有一些选项：

• 对于 macOS 用户：
  • 内置 Terminal，按 ⌘ command + space 然后输入 terminal；
  • iTerm2，您可以将其与 zsh 和 oh my zsh集成，用于颜色突出显示和其它高级功能。
• 对于 Windows 用户：
  • 内置命令行。在 Windows 任务栏，选择搜索图标或者输入cmd；
  • PowerShell；
  • Git Bash。这是建立在 Git for Windows 之上的。
• 对于 Linux 用户：
  • 内置 Linux Terminal。

安装 Git

通过打开终端并执行以下命令，来确定计算机上是否已经安装了 Git：

git --version

如果 Git 已经安装好，输出为：

git version X.Y.Z

如果您的计算机不识别 git命令，您必须安装 Git。安装之后，运行 git --version 来确认是否正确安装。

配置 Git

要开始在计算机上使用 Git，必须输入凭据，证明自己是作品的作者。用户名和电子邮件地址应该与您在极狐GitLab 中使用的一致。

1. 在 shell 中，添加您的用户名：

   git config --global user.name "your_username"
   

2. 添加您的邮件地址：

   git config --global user.email "your_email_address@example.com"
   

3. 检查配置, 运行:

   git config --global --list
   

--global 选项使得 Git 始终将此信息用于您在系统上执行的任何操作。如果省略 --global 或者用 --local，该配置仅适用于当前仓库。

您可以阅读Git 管理配置文档，获取有关 Git 如何管理配置的更多信息。

选择一个仓库

在开始之前，选择您要工作的仓库。您可以任何极狐GitLab 实例上使用您有权访问的任何项目。

要使用本页示例中的仓库，请执行以下操作：

1. 打开链接 https://gitlab.cn/gitlab-tests/sample-project/；
2. 在右上角，选择 派生；
3. 为您的派生项目选择一个命名空间。

该项目在 https://gitlab.cn/<您的命名空间>/sample-project/ 中可用。

您可以派生任何您可以访问的项目。

克隆一个仓库

当您克隆仓库时，远程仓库中的文件会被下载到您的计算机上，这样就建立了连接。

这个连接需要您添加凭据，您可以使用 SSH 或 HTTPS，推荐使用SSH。

用 SSH 进行克隆

当您只想进行一次验证时，使用 SSH 克隆。

1. 使用极狐GitLab 进行身份验证 ；
2. 跳转到项目页面并选择 克隆. 复制 使用 SSH 克隆 的URL；

3. 打开终端，进入要克隆文件的目录。Git 会自动创建一个带有仓库名称的文件夹并下载文件到该目录。

4. 运行命令:

   git clone git@gitlab.com:gitlab-tests/sample-project.git
   

5. 要查看这些文件，请转到目录:

   cd sample-project
   

您也可以克隆一个仓库，并直接在 Visual Studio Code 中打开它。

用 HTTPS 进行克隆

当您需要计算机和极狐GitLab 之间执行操作时均进行身份验证时，请使用HTTPS 进行克隆：

1. 转到项目的页面并选择 克隆. 复制 使用 HTTPS 克隆 的URL；
2. 打开终端，进入要克隆文件的目录；

3. 运行如下命令，Git 会自动创建一个带有仓库名称的文件夹并下载文件到该目录。

   git clone https://gitlab.com/gitlab-tests/sample-project.git
   

4. 极狐GitLab 需要您的用户名和密码:
   • 如果您的账户启用了 2FA, 您必须使用拥有 read_repository 或 write_repository 权限的个人访问令牌来代替您的密码；
   • 如果您没有启用 2FA，请直接使用账号密码。

5. 要查看这些文件，请转到目录:

   cd sample-project
   

将本地目录转换成仓库

您可以初始化本地文件夹，以便 Git 将其作为仓库进行跟踪。

1. 在要转换的目录中打开终端。

2. 运行命令：

   git init
   

在您的目录中创建了一个 .git 文件夹。该文件夹包含 Git 记录和配置文件，不建议直接编辑这些文件。

1. 添加到远端仓库的路径。这样 Git 就可以将文件上传到正确的项目中。

添加一个远端

您可以添加一个 “remote” 告诉 Git 与您计算机上的特定本地文件夹相关联的是极狐GitLab 中的哪个远程仓库。远端告诉 Git 从哪里 push 或 pull。

将远端文件添加到本地副本：

1. 在极狐GitLab 中，来保存您的文件。
2. 访问这个项目的主页，往下滚动到 推送现有文件夹，并复制以 ` git remote add` 开头的命令。

3. 在您的计算机上, 在已初始化的目录中打开终端，粘贴刚复制的命令，并按 enter：

   git remote add origin git@gitlab.com:username/projectpath.git
   

在您做完这些之后, 您可以提交文件并且上传它们到极狐Gitlab。

查看远程仓库

要查看远程仓库，请输入:

git remote -v

-v 代表verbose。

下载项目中的最新更改

要处理项目的最新副本，使用 pull 以获取自上次克隆或拉取项目以来用户所做的所有更改。用您的默认分支替换 <name-of-branch> 来获取主分支代码，或将其替换为您当前所在分支的分支名称。

git pull <REMOTE> <name-of-branch>

当您克隆一个仓库，REMOTE 通常是 origin，仓库从这里克隆的。它指示远端服务器仓库的 SSH 或 HTTPS URL。<name-of-branch> 通常是默认分支的名字，但它可能是任何现有的分支。您可以根据需要创建附加的命名远端和分支。

可以从Git 远端文档了解更多 Git 如何管理远端仓库的信息。

分支

一个 branch 是您创建分支时仓库中文件的副本。 您可以在您的分支工作，而不会影响其他分支。当您准备好将更改添加到主代码库时，您可以将您的分支合并到默认分支中，例如，main。

在如下情况下使用分支：

• 想要向项目添加代码，但您不确定它是否正常工作；
• 正在与他人合作完成项目，并且不希望您的工作混乱；

一个新的分支通常被称为功能分支，不同于默认分支。

创建一个分支

创建一个功能分支：

git checkout -b <name-of-branch>

分支名称不能包含空格和特殊字符，只使用小写字母，数字，连字符(-)和下划线(_)。

切换分支

Git 中的所有工作都是在一个分支中完成的。 您可以在分支之间切换，以查看文件的状态和在该分支中的工作。

切换到现有分支：

git checkout <name-of-branch>

例如，要切换到 main 分支：

git checkout main

查看差异

查看本地提交的更改与您克隆或拉取的最新版本之间的差异：

git diff

查看更改的文件

当您添加、更改或删除文件或文件夹时，Git 知道这些更改。

检查哪些文件已更改：

git status

添加并提交本地更改

当您输入 git status，本地更改的文件显示为红色。这些变化可能是新建、修改或删除的文件或文件夹。

1. 添加要暂存的准备提交的文件：

   git add <file-name OR folder-name>
   

2. 对要添加的每个文件或文件夹重复步骤 1，或者，将所有文件暂存到当前目录和子目录中，输入 git add .。

3. 确认文件已经添加到暂存中；

   git status
   

   文件应该以绿色文本显示。

4. 提交暂存文件：

   git commit -m "COMMENT TO DESCRIBE THE INTENTION OF THE COMMIT"
   

准备并提交所有更改

有一个快捷方式，您可以将所有本地更改添加到暂存，并使用一个命令提交它们:

git commit -a -m "COMMENT TO DESCRIBE THE INTENTION OF THE COMMIT"

将更改推送到远端

将所有本地更改推到远端仓库:

git push <remote> <name-of-branch>

例如，要将本地提交推送到 origin 远端的 main 分支:

git push origin main

有时 Git 不允许您推送到仓库。相反，必须强制更新。

删除分支中的所有更改

放弃对跟踪文件的所有更改:

git checkout .

此操作删除对文件的更改，而不是文件本身。未跟踪的（新的）文件不会更改。

取消已添加到暂存区的所有更改

要取消暂存（删除）所有尚未提交的文件：

git reset

撤销最近的提交

撤销最近的提交：

git reset HEAD~1

此操作将更改的文件和文件夹保留在本地仓库中。

可以从Git 撤销事务文档了解更多关于 Git 撤销更改的不同方式。

将一个分支与默认分支合并

当您准备将更改添加到默认分支时，您可以将功能分支合并到其中。

git checkout <default-branch>
git merge <feature-branch>

在极狐Gitlab 中，通常会使用合并请求来合并您的修改，而不是用命令行。

Git 使用命令行的高级用法

有关更高级的 Git 技术的介绍，请参考 Git 变基，强制推送和合并冲突文档。

将派生仓库中的更改与上游同步

要在您的命名空间中创建仓库的副本, 您可以派生。对仓库副本所做的更改不会自动与原始项目同步。要使项目与原始项目保持同步，您需要从原始仓库中 pull。

您必须创建到远端仓库的链接，从原始仓库中拉取更改，通常将此远端仓库称为 upstream。 现在您可以从原始仓库，把 upstream 作为一个 <remote> 去 pull 最新更新，并使用 origin 来提交本地更改 并创建新的合并请求。