[C++] Git 使用教程（从入门到常用操作）

1. Git 简介

Git 是一款分布式版本控制系统，用来跟踪文件变化、协作开发、管理项目版本。
它是开源的，由 Linus Torvalds 在 2005 年开发，广泛用于开源与企业项目中。

2. 安装 Git

Windows

1. 前往 Git 官网 下载并安装。

2. 安装时建议勾选 Git Bash，方便在命令行使用。

Linux

sudo apt install git    # Ubuntu/Debian
sudo yum install git    # CentOS/RHEL

macOS

brew install git

3. 配置 Git

首次使用需要设置用户名和邮箱，这些会记录在提交历史中。

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

查看配置：

git config --list

4. 创建与克隆仓库

新建本地仓库

mkdir myproject
cd myproject
git init

克隆远程仓库

git clone https://github.com/用户名/仓库名.git

5. 常用工作流

1. 查看文件状态

git status

1. 将文件添加到暂存区

git add 文件名
git add .  # 添加所有改动

1. 提交更改

git commit -m "提交说明"

1. 查看提交历史

git log
git log --oneline --graph --decorate --all  # 简洁图形化查看

6. 连接远程仓库

git remote add origin 仓库地址
git remote -v   # 查看远程地址

7. 推送与拉取

推送本地分支到远程

git push origin 分支名
# 第一次推送建议：
git push -u origin main

拉取远程分支更新

git pull origin 分支名

8. 分支管理

git branch                # 查看分支
git branch 新分支         # 创建分支
git checkout 分支名        # 切换分支
git checkout -b 新分支     # 创建并切换
git merge 分支名           # 合并分支
git branch -d 分支名       # 删除分支

9. 回退与撤销

回退到上一个提交

git reset --hard HEAD^

撤销文件修改

git checkout -- 文件名

10. .gitignore 忽略文件

在项目根目录创建 .gitignore 文件，写入要忽略的内容：

node_modules/
*.log
*.tmp
.DS_Store

11. 常用技巧

• 查看某个文件的历史：

git log 文件名

• 查看两个版本的差异：

git diff 版本1 版本2

• 暂存当前修改：

git stash
git stash pop

12. 常见问题

1. 推送报错 non-fast-forward
原因：远程有新的提交，本地落后。
解决：

git pull --rebase origin 分支名
git push origin 分支名

2. 误删分支
如果分支还在 reflog 中，可以恢复：

git reflog
git checkout 版本号

📌 总结

• Git 三个关键区域：工作区 → 暂存区 → 仓库。

• 常用四步：

  git add .
  git commit -m "说明"
  git push
  git pull
  

• 养成写清晰提交信息的习惯。