Git面向初学者的简明指南

第一阶段：安装与配置

1. 安装 Git

• Windows： 访问 Git 官网 下载安装程序，按默认选项安装即可。安装后，你可以在任意文件夹内右键点击，选择“Git Bash Here”来打开命令行工具。

• macOS：

  • 简单方法： 在终端（Terminal）中输入 git --version，如果未安装，它会提示你安装。
  • 推荐方法： 安装 Homebrew，然后在终端中输入 brew install git。

• Linux： 使用系统自带的包管理器安装，例如：

  • Ubuntu/Debian: sudo apt install git
  • CentOS/Fedora: sudo yum install git 或 sudo dnf install git

2. 初始配置

安装完成后，第一件事是设置你的用户名和邮箱，这个信息会记录在你的每一次提交中。

打开终端（或 Git Bash）并执行：

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"`

（--global 选项表示这台机器上所有的 Git 仓库都会使用这个配置）

第二阶段：本地仓库基本操作

本地操作是 Git 的核心，通常围绕一个工作流程进行。

基本工作流程：工作区 -> 暂存区 -> 仓库

1. 创建仓库

有两种常见情况：

• 将现有项目变为 Git 仓库：

cd /path/to/your/project  # 进入项目文件夹
git init                  # 初始化，会创建一个 .git 隐藏文件夹

从远程仓库克隆（下载）一个已有项目：

git clone https://github.com/用户名/仓库名.git
# 例如：git clone https://github.com/username/my-project.git

2. 检查状态与查看修改

在进行任何操作前，最好先检查一下状态。

• git status： 查看哪些文件被修改了，哪些文件已暂存准备提交。这是你最常用的命令之一。
• git diff： 查看文件具体修改了什么内容。

3. 添加文件到暂存区

将你想要在下次提交中包含的文件快照保存到暂存区。

• git add 文件名： 添加某个特定文件。
• git add . 或 git add --all： 添加所有变化的文件（新建、修改、删除）。

4. 提交更改到仓库

将暂存区的内容永久保存到仓库的历史记录中。

• git commit -m "提交说明"

  • -m 后面跟的是本次提交的说明，务必清晰明了，例如 “修复了登录页面的BUG” 或 “新增了用户注册功能”。

示例一次完整的修改到提交：

# 1. 修改了 index.html 和 style.css 文件
# 2. 检查状态
git status
# 3. 添加所有修改
git add .
# 4. 提交
git commit -m "更新主页布局和样式"

5. 查看历史记录

• git log： 查看提交历史。
• git log --oneline： 以简洁的一行格式查看历史。

---

第三阶段：远程仓库与协作

为了备份代码或与他人协作，需要将本地仓库同步到远程服务器（如 GitHub, Gitee, GitLab）。

1. 关联远程仓库

• 如果你是从 git clone 开始的，远程仓库通常已经自动关联，名为 origin。

• 如果是本地 git init 的仓库，需要手动添加：

  bash

  git remote add origin https://github.com/用户名/仓库名.git
  

2. 推送到远程仓库

将本地的提交上传到远程仓库。

• git push -u origin 分支名

  • 例如第一次推送主分支：git push -u origin main (或 master)
  • -u 是 --set-upstream 的简写，表示记录关联，下次直接 git push 即可。

3. 从远程仓库拉取更新

当别人推送了更新，你需要将这些更新下载到本地并与你的工作合并。

• git pull： 相当于 git fetch（获取更新） + git merge（合并到当前分支）。

---

第四阶段：分支管理

分支是 Git 的杀手锏功能，它让你可以在不同的线上开发功能，互不干扰。

1. 创建与切换分支

• git branch 新分支名： 创建新分支。
• git checkout 分支名： 切换到指定分支。
• git checkout -b 新分支名： 创建并切换到新分支（常用）。

2. 合并分支

当你完成某个功能的开发后，需要将其合并回主分支。

1. 首先，切换回主分支：git checkout main
2. 然后，合并特性分支：git merge 特性分支名

3. 处理合并冲突

当 Git 无法自动合并分歧时，就会产生冲突。你需要手动编辑文件中标有 <<<<<<<, =======, >>>>>>> 的部分，解决冲突后，再执行 git add . 和 git commit 来完成合并。

---

常用命令总结表

命令	作用
git init	初始化本地仓库
git clone <url>	克隆远程仓库
git add <file>	添加文件到暂存区
git commit -m "msg"	提交到本地仓库
git status	查看仓库状态
git log	查看提交历史
git push	推送到远程仓库
git pull	从远程拉取更新
git checkout -b <branch>	创建并切换分支
git merge <branch>	合并分支

新手建议

1. 多用 git status： 在任何你不确定的时候，输入 git status，Git 通常会告诉你该做什么。
2. 提交信息要清晰： 这是好习惯，方便未来你和你的队友回顾历史。
3. 先 pull 后 push： 在协作中，推送前先拉取一下，确保你的本地代码是最新的，可以避免很多冲突。
4. 大胆使用分支： 分支成本极低，为新功能或修复 Bug 创建新分支是一个非常好的实践。