Git 详细使用说明文档（适合小白）

Git 详细使用说明文档（适合小白）

1. 什么是 Git？

Git 是一个版本控制系统，帮助你管理和跟踪代码的变更。无论是个人项目还是团队协作，Git 都能帮助你记录代码的历史版本，方便回溯和协作。

2. 安装 Git

• Windows：从 Git 官网 下载安装包并运行。
• Mac：打开终端，输入 git --version，系统会提示安装。
• Linux：使用包管理器安装，如 sudo apt-get install git（Ubuntu）。

安装完成后，打开终端（Windows 用户可以使用 Git Bash），输入 git --version 确认安装成功。

3. 配置 Git

首次使用 Git，需要配置用户名和邮箱，这是提交代码时的身份标识。

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

4. 创建 Git 仓库

Git 仓库（Repository）是存储代码和版本历史的地方。

• 本地创建：在项目文件夹中运行 git init，会创建一个 .git 隐藏文件夹。
• 克隆远程仓库：使用 git clone <远程仓库URL>，如 git clone https://github.com/user/repo.git。

5. 基本操作

5.1 查看状态

git status

显示当前工作区的状态，包括哪些文件被修改、哪些文件待提交等。

5.2 添加文件

将修改的文件添加到暂存区（Staging Area）。

git add <文件名>

• 添加所有文件：git add .
• 添加特定文件：git add file.txt

5.3 提交更改

将暂存区的文件提交到本地仓库，并附上提交信息。

git commit -m "提交信息"

提交信息应简洁明了，描述本次提交的内容。

5.4 查看提交历史

git log

显示提交历史，包括提交者、时间、提交信息等。

6. 远程仓库

远程仓库是托管在网络上的 Git 仓库，如 GitHub、GitLab 等。

6.1 添加远程仓库

git remote add origin <远程仓库URL>

origin 是远程仓库的别名，可以自定义。

6.2 推送代码

将本地仓库的代码推送到远程仓库。

git push origin <分支名>

首次推送可能需要 -u 参数：git push -u origin master。

6.3 拉取代码

从远程仓库拉取最新代码到本地。

git pull origin <分支名>

7. 分支管理

分支（Branch）允许你在不影响主代码的情况下开发新功能。

7.1 创建分支

git branch <分支名>

7.2 切换分支

git checkout <分支名>

或者使用 git switch <分支名>（Git 2.23+）。

7.3 合并分支

将一个分支的更改合并到当前分支。

git merge <分支名>

7.4 删除分支

git branch -d <分支名>

8. 解决冲突

当多人修改同一文件时，可能会产生冲突。Git 会提示冲突文件，你需要手动编辑文件解决冲突，然后再提交。

9. 其他常用命令

• 撤销修改：
  • 撤销工作区的修改：git checkout -- <文件名>
  • 撤销暂存区的修改：git reset HEAD <文件名>
• 查看差异：
  • 比较工作区和暂存区：git diff
  • 比较暂存区和最后一次提交：git diff --staged
• 标签：
  • 创建标签：git tag <标签名>
  • 推送标签：git push origin <标签名>

10. 学习资源

• Git 官方文档
• Pro Git 中文版
• GitHub 学习资源

希望这份文档能帮助你快速上手 Git！如果有任何问题，欢迎随时提问。