本文旨在为初学者和进阶用户提供一份清晰、实用的 Git 使用指南。Git 是目前世界上最先进的分布式版本控制系统。

1. 基础配置

在开始使用 Git 之前，你需要配置你的身份标识。

# 设置全局用户名
git config --global user.name "你的名字"

# 设置全局邮箱
git config --global user.email "你的邮箱@example.com"

# 查看配置列表
git config --list

2. 基础工作流

Git 的核心工作流通常涉及以下几个步骤：

初始化仓库

# 在当前目录初始化一个新的 Git 仓库
git init

状态查询

# 查看当前工作区的状态（哪些文件被修改了，哪些在暂存区）
git status

添加到暂存区

# 添加指定文件到暂存区
git add <filename>

# 添加所有修改过的文件到暂存区
git add .

提交到本地仓库

# 提交暂存区内容到仓库，并添加提交说明
git commit -m "提交说明内容"

查看日志

# 查看提交历史
git log

# 以精简的一行形式查看日志
git log --oneline

3. 分支管理

分支是 Git 的杀手锏功能，允许你同时进行多个任务。

命令说明
git branch列出本地所有分支
git branch <name>创建一个名为 <name> 的新分支
git checkout <name>切换到指定分支
git checkout -b <name>创建并立即切换到新分支
git merge <name>将指定分支合并到当前分支
git branch -d <name>删除已合并的分支

4. 远程协作

当你需要与他人协作时，远程仓库（如 GitHub/GitLab）是必不可少的。

# 添加远程仓库地址
git remote add origin <url>

# 从远程仓库拉取最新代码并合并
git pull origin <branch_name>

# 将本地提交推送到远程仓库
git push origin <branch_name>

# 克隆一个远程仓库到本地
git clone <url>

5. 撤销与回滚

在开发过程中，难免会犯错。Git 提供了多种方式来挽回。

  • 丢弃工作区的修改（未 add）：

    git checkout -- <filename>

  • 撤销暂存区的修改（已 add 未 commit）：

    git reset HEAD <filename>

  • 版本回退：

    # 回退到上一个版本
git reset --hard HEAD^

# 回退到指定提交（通过 hash 值）
git reset --hard <commit_id>

6. 实用小技巧

.gitignore 文件

在项目根目录创建 .gitignore 文件，可以告诉 Git 忽略哪些文件（如 node_modules/, .env, 日志文件等）。

暂存更改 (Stash)

当你需要切换分支但当前工作还没完成时，可以使用 stash：

# 暂存当前更改
git stash

# 恢复暂存的更改
git stash pop

希望这份指南能帮助你更高效地使用 Git！如有疑问，欢迎在评论区留言。