• Git 命令行使用指南
  • 第一部分：配置 Git
    • 1.1 设置用户信息
    • 1.2 配置换行符处理
  • 第二部分：创建和配置仓库
    • 2.1 初始化仓库
    • 2.2 克隆仓库
    • 2.3 递归克隆
    • 2.4 深度克隆
  • 第三部分：基本操作
    • 3.1 添加文件
    • 3.2 提交更改
    • 3.3 查看状态和提交历史
    • 3.4 创建和切换分支
    • 3.5 解决冲突
    • 3.6 合并分支
    • 3.7 拉取远程更改
    • 3.8 创建本地分支跟踪远程分支
    • 3.9 添加子模块
  • 第四部分：远程仓库操作
    • 4.1 添加远程仓库
    • 4.2 推送更改到远程仓库
  • 第五部分：撤销更改
    • 5.1 撤销更改

Git 命令行使用指南

Git 是一个强大的分布式版本控制系统，用于跟踪和管理软件项目的更改。本指南将详细介绍 Git 的基本用法，以帮助您开始使用 Git 来管理您的项目。

第一部分：配置 Git

1.1 设置用户信息

在开始使用 Git 之前，您需要配置您的用户信息，包括姓名和电子邮件地址。这将用于记录您的提交信息。

git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"

1.2 配置换行符处理

在不同操作系统上，换行符的表示方式不同。为了确保在不同平台上的一致性，您可以配置 Git 处理换行符的方式。

git config --global core.autocrlf <value>

<value> 的选项可以是 true、false 或 input，具体取决于您的需求。通常，在 Windows 上使用 true，在 Unix/Linux 上使用 false 或 input。

第二部分：创建和配置仓库

2.1 初始化仓库

要开始使用 Git，您需要创建一个新的仓库或克隆一个现有的仓库。使用以下命令初始化一个新仓库：

git init my-repo

这将在当前目录下创建一个名为 my-repo 的新仓库。

2.2 克隆仓库

如果您要克隆一个已经存在的仓库，可以使用以下命令：

git clone <repository-url>

这将复制远程仓库的内容到您的本地计算机，并创建一个与远程仓库相同的本地副本。

2.3 递归克隆

有些仓库包含子模块，即其他仓库的嵌套。要递归克隆包含子模块的仓库，使用 --recursive 选项：

git clone --recursive <repository-url>

这将克隆主仓库及其所有子模块。

2.4 深度克隆

深度克隆是指仅克隆仓库的部分历史记录，而不是完整地将整个历史记录克隆到本地。这对于减小仓库大小和节省带宽很有用。

要进行深度克隆，使用 --depth 选项，并指定要克隆的提交数量：

git clone --depth=<depth> <repository-url>

如果你仅需要最新的内容，使用 git clone --depth=1 <repository-url> 即可。

如果您已经使用深度克隆克隆了一个仓库，想要获取更多历史记录，可以使用以下命令：

git fetch --unshallow

这将从远程仓库获取完整的历史记录。

第三部分：基本操作

3.1 添加文件

在 Git 中，您需要明确告诉 Git 哪些文件应该被跟踪。使用以下命令将文件添加到暂存区：

git add .

. 表示当前目录下的所有文件。您也可以指定特定文件名来添加单个文件。

3.2 提交更改

一旦您将文件添加到暂存区，您可以使用以下命令来提交更改：

git commit -m "描述你的更改"

这将创建一个提交，将您的更改保存到 Git 仓库中，并附带一条描述信息。

3.3 查看状态和提交历史

要查看仓库的状态以及提交历史，可以使用以下命令：

git status
git log

git status 显示未提交的更改，而 git log 显示提交历史。

3.4 创建和切换分支

分支是 Git 的强大功能之一，允许您在不影响主分支的情况下开发新功能或修复错误。要创建和切换分支，使用以下命令：

git branch <branch-name>
git checkout <branch-name>

<branch-name> 是您为分支指定的名称。

3.5 解决冲突

在多人协作或切换分支时，可能会遇到冲突。冲突发生在两个分支修改了相同部分的文件时。要解决冲突，打开冲突文件，手动编辑文件以保留您需要的更改，然后使用以下命令标记冲突已解决：

git add <resolved-file>
git commit -m "解决冲突：描述冲突解决的内容"

3.6 合并分支

要将分支合并到主分支或其他分支，使用以下命令：

git merge <branch-name>

这将将指定分支的更改合并到当前分支。

3.7 拉取远程更改

在协作中，需要拉取其他人对仓库的更改以保持同步。使用以下命令拉取远程更改：

git fetch --all

3.8 创建本地分支跟踪远程分支

要在本地创建一个分支并将其与远程分支关联，使用以下命令：

git checkout -b 本地分支名 origin/远程分支名

这将创建一个本地分支，并将其与指定的远程分支关联起来，以便跟踪远程仓库的更改。

3.9 添加子模块

Git 子模块允许您将一个 Git 仓库作为另一个 Git 仓库的子目录。要添加子模块，可以使用以下命令：

git submodule add <repository-url> <path>

这将在指定的 <path> 目录下添加一个子模块，与指定的 <repository-url> 仓库关联。

第四部分：远程仓库操作

4.1 添加远程仓库

要与远程仓库进行交互，您需要将其添加为 Git 仓库的远程源。使用以下命令添加远程仓库：

git remote add origin <repository-url>

origin 是通常用于远程仓库的默认名称，但您可以选择其他名称。

4.2 推送更改到远程仓库

要将本地更改推送到远程仓库，使用以下命令：

git push origin <branch-name>

这将确保您的更改与远程仓库保持同步。

第五部分：撤销更改

5.1 撤销更改

有时，您可能需要撤销提交或更改。使用以下命令可以实现不同级别的撤销：

• git reset 用于取消提交并将更改保留在工作区。
• git reset HEAD~1 用于取消最新的提交，并将更改保留在工作区和暂存区。

这些是 Git 的基本用法，但 Git 是一个非常强大的工具，还有许多高级功能和选项可供探索。继续学习和掌握 Git 将使您更好

更多内容请参考: https://git-scm.com/docs