Git 入门：从基础到实践 – wiki词典

作者： /

Git 入门：从基础到实践

Git 是目前世界上最流行、最先进的分布式版本控制系统。它能够高效地处理从小到大的所有项目，无论是个人项目还是大型团队协作。掌握 Git 不仅是现代软件开发者的必备技能，也是提高团队协作效率、保障代码质量的重要工具。

本文将从 Git 的基本概念出发，逐步深入到常用命令和实践技巧，帮助您快速入门并掌握 Git。

第一部分：Git 核心概念

在使用 Git 之前，理解其几个核心概念至关重要：

  1. 版本库 (Repository)：也称为仓库，是 Git 用来存储项目所有版本数据的地方。一个版本库通常包含.git目录（存放所有 Git 追踪信息）和项目文件。
  2. 工作区 (Working Directory)：您在电脑上看到的目录，包含您正在编辑和修改的实际文件。
  3. 暂存区 (Staging Area / Index)：一个位于版本库中，用于暂时存放您即将提交的更改的文件集合。您可以把暂存区想象成一个缓冲区，用来准备下一次提交（commit）。
  4. 提交 (Commit)：将暂存区中的所有更改永久保存到版本库中。每一次提交都会生成一个唯一的 ID，代表了项目的一个特定版本快照。

这三者之间的关系可以简单理解为：
* 您在工作区修改文件。
* 将修改后的文件添加到暂存区。
* 将暂存区的文件提交到版本库。

第二部分：Git 安装与配置

1. 安装 Git

根据您的操作系统，选择相应的安装方式：

  • Windows: 访问 Git 官方网站 (https://git-scm.com/download/win) 下载并运行安装程序。
  • macOS: 可以通过 Homebrew (brew install git) 或下载官方安装包。
  • Linux: 大多数 Linux 发行版都可以通过包管理器安装，例如 Debian/Ubuntu: sudo apt-get install git。

安装完成后，在命令行输入 git --version 检查是否安装成功。

2. 配置用户信息

在使用 Git 之前，您需要设置您的用户名和邮箱地址。这些信息会伴随您的每一次提交，用于标识提交者。

bash
git config --global user.name "Your Name"
git config --global user.email "[email protected]"
--global 参数表示这些配置将应用于您所有 Git 仓库。如果您希望为特定项目设置不同的信息，可以在项目目录下不带 --global 参数执行上述命令。

第三部分：Git 基础命令

1. 创建新仓库

  • 初始化新仓库：在一个空目录或现有项目目录下，将其转换为 Git 仓库。
    bash
    git init
    执行后，会在当前目录下创建一个 .git 隐藏目录，这就是 Git 版本库。

  • 克隆远程仓库：从一个远程服务器（如 GitHub, GitLab）复制一个已有的 Git 仓库到本地。
    bash
    git clone <repository_url>
    例如：git clone https://github.com/octocat/Spoon-Knife.git

2. 添加与提交

  • 查看工作区状态：了解当前文件处于什么状态（未跟踪、已修改、已暂存等）。
    bash
    git status

  • 添加文件到暂存区：将工作区的修改添加到暂存区，准备提交。
    bash
    git add <file_name> # 添加指定文件
    git add . # 添加所有新文件和修改过的文件到暂存区

  • 提交更改：将暂存区的内容提交到版本库。
    bash
    git commit -m "Your commit message"
    -m 后跟着的是本次提交的说明信息，一个好的提交信息能够清晰地描述本次提交的目的和内容。

3. 查看历史与差异

  • 查看提交历史：显示所有提交记录，包括作者、日期、提交信息和提交 ID。
    bash
    git log # 查看所有提交历史
    git log --oneline # 简洁模式，每条提交一行显示
    git log --graph --oneline --decorate # 以图形方式查看分支合并历史

  • 查看文件差异：比较文件在不同状态下的差异。
    bash
    git diff # 查看工作区与暂存区文件的差异
    git diff --cached # 查看暂存区与上次提交文件的差异
    git diff HEAD # 查看工作区与上次提交文件的差异

第四部分：分支管理

分支 (Branch) 是 Git 的核心特性之一，它允许您从主开发线中分离出一个独立的开发路径，进行新功能开发、bug 修复等，而不会影响主线的稳定性。

1. 分支操作

  • 查看分支：
    bash
    git branch # 列出所有本地分支
    git branch -a # 列出所有本地和远程分支
    当前分支会用 * 标识。

  • 创建分支：
    bash
    git branch <new_branch_name>
    此命令只创建分支，不会自动切换过去。

  • 切换分支：
    bash
    git checkout <branch_name>
    或在新版 Git 中，推荐使用：
    bash
    git switch <branch_name>

  • 创建并切换分支：
    bash
    git checkout -b <new_branch_name>
    或新版 Git 中：
    bash
    git switch -c <new_branch_name>

  • 删除分支：
    bash
    git branch -d <branch_name> # 删除已合并的分支
    git branch -D <branch_name> # 强制删除未合并的分支
    不能删除当前所在的分支。

2. 合并分支

当您在一个分支上完成开发后，通常需要将其合并回主分支（如 main 或 master）。

  • 合并分支：首先切换到目标分支（例如 main），然后合并其他分支。
    bash
    git checkout main
    git merge <feature_branch_name>
    合并过程中可能会出现冲突 (Conflict)，这意味着两个分支对同一个文件的同一部分进行了不同的修改。此时，Git 会提示冲突文件，您需要手动编辑这些文件，解决冲突后再次 git add 并 git commit。

第五部分：远程仓库协作

Git 的强大之处在于分布式协作。您可以在本地进行开发，然后将更改推送到远程仓库，或从远程仓库拉取他人的更改。

1. 远程仓库基本操作

  • 查看远程仓库：
    bash
    git remote -v
    通常会看到 origin，这是 Git 默认的远程仓库名称。

  • 添加远程仓库：如果您从头开始创建本地仓库，需要关联一个远程仓库。
    bash
    git remote add origin <remote_repository_url>

  • 推送更改 (Push)：将本地分支的提交推送到远程仓库。
    bash
    git push origin <branch_name>
    首次推送新分支时，可能需要使用 -u 参数设置上游分支：
    bash
    git push -u origin <branch_name>
    之后只需 git push 即可。

  • 拉取更改 (Pull)：从远程仓库获取最新更改并合并到当前本地分支。
    bash
    git pull origin <branch_name>
    git pull 实际上是 git fetch (获取远程更改) 和 git merge (合并到本地) 的组合。

  • 获取更改 (Fetch)：从远程仓库获取最新更改，但不会自动合并。
    bash
    git fetch origin <branch_name>
    获取后，您可以通过 git diff 比较 HEAD 和 origin/<branch_name> 来查看差异，然后决定是否手动合并。

第六部分：撤销更改与回溯

Git 提供了强大的机制来撤销或修改历史提交，但请谨慎使用，尤其是对于已推送到远程仓库的提交。

  • 撤销工作区修改：
    bash
    git restore <file_name> # 撤销指定文件的所有修改（回到上次提交或暂存状态）
    git restore . # 撤销工作区所有未暂存的修改
    这会将文件恢复到 HEAD（或暂存区）的状态。

  • 撤销暂存区修改：
    bash
    git restore --staged <file_name> # 将文件从暂存区移除，但保留工作区修改

  • 版本回溯 (Reset)：回退到指定提交，可以修改提交历史。
    bash
    git reset --soft <commit_id> # 回退到指定提交，保留工作区和暂存区修改
    git reset --mixed <commit_id> # 回退到指定提交，保留工作区修改，清空暂存区 (默认)
    git reset --hard <commit_id> # 回退到指定提交，彻底删除工作区和暂存区的所有修改 (慎用!)
    <commit_id> 可以是提交的 SHA-1 值（部分即可），也可以是 HEAD~N (HEAD 指针向前 N 个提交)。

  • 撤销已提交的更改 (Revert)：创建一个新的提交来撤销之前的某个提交，保留历史记录。
    bash
    git revert <commit_id>
    revert 是一种“安全”的撤销方式，因为它不会改写历史，而是通过生成一个新的“反向”提交来抵消之前提交的效果。

第七部分：Git 最佳实践与工作流

1. 规范提交信息

清晰、有意义的提交信息对于项目维护和团队协作至关重要。

  • 简明扼要的主题行：第一行不超过 50-72 个字符，概括提交内容。
  • 空一行：主题行和正文之间空一行。
  • 详细描述：正文部分详细说明本次提交的原因、解决了什么问题、引入了什么新功能、可能产生的影响等。

示例：
“`
feat: Add user authentication module

This commit introduces a new user authentication module,
including signup, login, and logout functionalities.
It uses JWT for session management and integrates with
the existing database schema.

Resolves: #123
“`

2. 常用的分支工作流

  • Git Flow：一种复杂但强大的分支模型，适用于大型、长期维护的项目。它定义了 master (生产环境)、develop (开发集成)、feature (功能开发)、release (发布准备)、hotfix (紧急修复) 等多个分支。
  • GitHub Flow / GitLab Flow：更轻量、更简单的工作流，适用于持续集成和持续部署 (CI/CD) 的项目。通常围绕一个 main (或 master) 分支展开，所有功能和修复都在单独的分支上开发，完成后通过拉取请求 (Pull Request / Merge Request) 合并回 main 分支。

对于初学者和大多数中小型项目，GitHub Flow 或 GitLab Flow 更易于上手和实践。

总结

本文从 Git 的基本概念、安装配置、常用命令到分支管理和远程协作，为您提供了一个全面的入门指南。掌握 Git 不仅仅是记住命令，更重要的是理解其背后的原理和工作流，这样才能在实际开发中游刃有余。

后续学习方向：

  • Git 高级命令：rebase (变基)、stash (贮藏)、cherry-pick (拣选)、reflog (引用日志) 等。
  • Pull Request / Merge Request：在 GitHub/GitLab 等平台上的协作方式。
  • Git Hooks：自定义 Git 行为的脚本。
  • 图形化 Git 工具：如 SourceTree, GitKraken 等，它们提供了直观的用户界面。

祝您在 Git 的世界中探索愉快，代码版本管理得心应手！

滚动至顶部