Git从0手把手实战指南 | 新手到高手完整教程（安装、配置、分支、协作全覆盖）

$ git --version
# 执行结果
git version 2.40.1.windows.1

# 配置 user.name user.email 建议这里的 user.email 使用真实邮箱
$ git config --global user.name " 你的用户名 "​
$ git config --global user.email " 你的邮箱地址 "
 
# 查看 是否生效
$ cat .gitconfig

# 配置 VS Code
$ git config --global core.editor "code --wait"
 
# 查看全局配置的文本编辑器
$ git config --global core.editor
 
# 执行结果
code --wait

# 仓库初始化
$ git init
# 执行结果
Initialized empty Git repository in C:/Users/17461/learn/.git/
 
# 观察隐藏的 .git 文件夹 - Git 的“大脑”
$ cat .git/config
# 执行结果说明
[core]
    repositoryformatversion = 0  # 仓库格式版本（固定为 0）
    filemode = false              # 记录文件权限变化（Linux/macOS 常用，Windows 通常为 false）
    bare = false                 # 是否为裸仓库（false 表示常规仓库，有工作区）
    logallrefupdates = true      # 记录所有引用（分支、标签）的更新日志
    ignorecase = true            # 是否忽略文件名大小写（Windows/macOS 常见）
    editor = code --wait         # 当前仓库单独配置的默认文本编辑器（覆盖全局）

# 1. 新建一个测试文件
$ vi test.txt
 
# 保存后查看状态
$ git status
 
# 将文件添加至暂存区
$ git add test.txt

# 仅将指定文件的当前变更（修改 / 新增 / 删除）加入暂存区，其他文件不受影响。
  git add <filename>
 
# 添加当前目录（包括子目录）下的所有新增文件和已跟踪文件的修改 / 删除，但不包括被删除的未跟踪文件。
  git add .
 
# 添加所有变更，包括新增文件、已跟踪文件的修改 / 删除、被删除的未跟踪文件，覆盖范围比 git add . 更全面。
  git add -A（或 git add --all）

# 将暂存区的所有变更打包成一个“提交记录”，存入本地仓库，同时生成唯一标识（SHA-1 哈希值）。
  git commit -m " 清晰、有意义的提交说明 "

# 简洁模式，每条提交仅显示哈希值前 7 位和提交说明，适合快速浏览历史。
  git log --oneline
 
# 以图形化方式展示分支合并历史，直观呈现分支关系（如 * 表示提交，| 表示分支线）。
  git log --graph
# 自定义输出格式，常用 --pretty=fuller 显示完整提交信息（包括作者、提交者、时间戳），或 --pretty=format:"%h %an %s" 按需提取信息（%h 短哈希、%an 作者名、%s 提交说明）。
  git log --pretty=< 格式 >
 
# 以图形化线条展示所有分支的提交历史和合并关系
  git log --graph --oneline --all

# 比较工作区与暂存区
  git diff（查看未暂存的修改）。
# 比较暂存区与本地仓库
  git diff --staged（查看已暂存、待提交的修改）。
# 比较两个提交
  git diff <提交 1> < 提交2>（如 git diff a3f8d2e b7c9d01，查看两次提交的差异）。
# 比较两个分支
  git diff 分支 1  分支 2（如 git diff main dev，查看两分支最新提交的差异）。

# 查看最新提交
  git show（默认显示  HEAD  指向的最新提交）。
# 查看指定提交
  git show <提交哈  希>（如 git show a3f8d2e，显示该提交的详细变更）。
# 查看标签对应的提交
  git show <标签  名>（如 git show v1.0，查看标签指向的提交详情）。

# 创建分支：
  git branch <分支  名>（如 git branch feature/login）
 
# 切换分支：
  git checkout <分支  名>（如 git checkout dev）
 
# 新版切换分支：
  git switch <分支  名>（更直观，如 git switch main）
 
# 创建并切换：
  git switch -c <新分支  名>（一步完成创建  +  切换）

# 显示本地所有分支，当前分支前标 *
  git branch
# 显示本地 + 远程所有分支（远程分支以 remotes/ 开头）
  git branch -a

# 将指定分支的代码整合到当前分支
  git merge <待合并分  支>

#  生成密钥对
   ssh-keygen -t ed25519 -C " 建议与远程平台账号关联的邮箱 "
 
#  查看并复制公钥内容
   cat ~/.ssh/id_ed25519.pub

# 将本地仓库与远程仓库关联
  git remote add <远程名  称> <仓库地  址>
# 建立本地仓库与远程仓库的映射，后续可通过 origin 指代该远程仓库。
  git remote add origin https://gitee.com/yourname/yourrepo.git

# 列出当前仓库关联的所有远程仓库，包括名称和对应的 fetch（拉取）、push（推送）地址。
  git remote -v（-v 表示显示详细地址）

# 获取完整项目 (git clone) - 初始化远程关联的快捷方式
  git clone https://gitee.com/yourname/yourrepo.git

# 获取远程仓库 origin 的所有更新
  git fetch origin  
 
# 仅获取远程 main 分支的更新
  git fetch origin main  

# 对比本地当前分支与远程 main 的差异
  git diff origin/main 
 
# 手动将远程更新合并到当前分支
  git merge origin/main 

# 第一次推送加 -u 建立追踪
  git push -u origin 
 
# 后续推送简化
  git push
 
# 推送到仓库的哪个分支（dev master）
  git push github（仓库别名） main(分支)

# 撤销对 test.txt 的本地修改。
  git checkout -- test.txt

# 传统：
  git reset HEAD  test.txt
# 新版：
  git restore --staged  test.txt

# 仅改注释：执行命令后编辑新注释，保存即可。补充文件：
  git add 漏掉的文件 
  git commit --amend。

git reset <版  本>（修改历史，有风险）

git revert <版  本>（安全回退）

# 生成新提交撤销 a1b2c3d 的修改。
  git revert a1b2c3d