Git 是分布式版本控制系统，核心用于代码版本管理、回溯及多人协作。本文作为个人备忘，聚焦核心操作的原理与关键命令，精简实用，方便快速查阅。
前置准备：安装Git后，终端输入 git --version 显示版本号即安装成功（Windows用Git Bash，Mac/Linux用终端）。
一、基础配置：身份与认证（必做）
原理：Git无统一“登陆”概念，配置本地身份用于标识提交者，绑定远程认证用于本地与远程仓库同步，未配置会导致提交/推送失败。
1. 本地用户名/邮箱配置（身份标识）
提交记录会关联该信息，建议与远程仓库账户一致，分全局（所有仓库）和局部（单个仓库）配置。
# 全局配置（推荐新手）
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"# 局部配置（多账户场景，需先进入仓库目录）
git config user.name "你的用户名"
git config user.email "你的邮箱"# 验证配置
git config --list
2. 远程仓库认证（密码/Token/SSH）
原理：远程仓库（GitHub/Gitee）需身份认证，确认操作权限，密码认证已基本废弃，优先Token，频繁操作推荐SSH。
-
Token认证：远程仓库个人设置生成Token（勾选repo权限），首次推送时，密码处粘贴Token即可。
-
SSH认证：生成密钥对，公钥配置到远程仓库，无需重复输入凭证。
`# 生成密钥（替换邮箱）
ssh-keygen -t rsa -b 4096 -C "你的邮箱"
验证（GitHub/Gitee分别执行）
ssh -T git@github.com
ssh -T git@gitee.com`
二、本地仓库：创建与删除（本地版本管理基础）
原理：本地仓库是Git版本管理的核心，本质是存储代码版本信息的目录（含隐藏.git文件夹，不可手动删除）。
1. 创建本地仓库（两种场景）
# 场景1：从零创建（新建项目）
mkdir 项目文件夹 && cd 项目文件夹
git init # 初始化仓库，生成.git文件夹# 场景2：克隆远程仓库（已有远程项目）
git clone 远程仓库HTTPS/SSH地址 # 自动生成本地仓库，无需git init
2. 删除本地仓库
原理：删除仓库即删除对应文件夹（含.git），本地版本记录全部丢失，谨慎操作。
# 退出仓库目录，删除文件夹（Mac/Linux）
cd 上级目录 && rm -rf 仓库文件夹
# Windows（Git Bash）
cd 上级目录 && rd /s/q 仓库文件夹# 仅取消Git管理（保留项目文件）
cd 仓库目录 && rm -rf .git
三、远程关联：本地与远程同步桥梁
原理：通过关联远程仓库地址，实现本地代码推送（备份）和远程代码拉取（同步），origin是远程仓库默认别名。
# 1. 首次关联（进入本地仓库）
git remote add origin 远程仓库地址# 2. 核心辅助命令
git remote -v # 验证关联（显示origin对应地址）
git remote set-url origin 新地址 # 修改远程地址
git remote rm origin # 解除关联
git pull origin main # 拉取远程main分支最新代码
四、分支操作：多任务并行开发
原理：分支相当于独立开发线，可在分支开发新功能/修Bug，不影响主分支稳定，开发完成后合并。
核心命令（备忘重点）
# 查看分支（*表示当前分支）
git branch # 本地分支
git branch -a # 本地+远程分支# 创建/切换/创建并切换分支
git branch 分支名
git switch 分支名（或git checkout 分支名）
git switch -c 分支名（或git checkout -b 分支名）# 合并分支（例：dev合并到main）
git switch main && git merge dev# 删除分支
git branch -d 分支名（已合并）
git branch -D 分支名（强制删除）# 远程分支操作
git push origin 分支名 # 推送本地分支到远程
git pull origin 分支名 # 拉取远程分支到本地
合并冲突解决
原理：两个分支修改同一文件同一部分，Git无法自动判断，需手动干预。
# 1. 合并提示冲突后，打开冲突文件，删除标记并修改内容
# 冲突标记：<<<<<<< HEAD（当前分支）、=======（分隔）、>>>>>>> 分支名（待合并）# 2. 标记解决并提交
git add 冲突文件名
git commit -m "fix: 合并冲突"
五、提交操作：本地与远程同步核心
原理：提交流程为「工作区→暂存区→本地仓库→远程仓库」，每一步均为版本记录的关键节点。
1. 本地提交（三步曲）
# 1. 查看文件状态（红色未暂存，绿色已暂存）
git status# 2. 工作区→暂存区
git add 单个文件 # 单个文件
git add -A # 所有修改（推荐）# 3. 暂存区→本地仓库（提交说明必填）
git commit -m "提交说明"（例：feat: 新增功能，fix: 修复Bug）# 补充：补充最近一次提交（未推送远程）
git commit --amend -m "修改后的提交说明"
2. 远程提交（推送）
# 1. 优先拉取远程最新代码，避免冲突
git pull origin 分支名# 2. 推送本地分支到远程
git push -u origin 分支名 # 首次推送，绑定分支
git push origin 分支名 # 非首次推送
六、其他必备操作（备忘）
1. 版本回退（误操作救星）
原理：通过提交哈希值或简化命令，回溯到历史稳定版本，--hard会彻底删除回退后续修改。
# 查看提交历史（获取哈希值，前7位即可）
git log --oneline# 回退操作
git reset --hard 哈希值 # 回退到指定版本
git reset --hard HEAD^ # 回退到上一版本# 已推送远程，需强制推送（谨慎，会覆盖远程记录）
git push -f origin 分支名
2. 忽略文件（.gitignore）
原理：指定无需Git管理的文件/文件夹（如日志、编译产物），避免误提交。
# 新建.gitignore文件，添加忽略规则（示例）
node_modules/ # 文件夹
*.log # 所有.log文件
.vscode/ # IDE配置文件夹
test.txt # 单个文件# 提交.gitignore
git add .gitignore && git commit -m "docs: 添加忽略文件"
3. 暂存工作区（git stash）
原理：临时保存未完成的修改，方便切换分支处理紧急问题，后续可恢复。
git stash save "暂存描述" # 暂存
git stash list # 查看暂存记录
git stash pop # 恢复最近暂存并删除记录
git stash clear # 清空所有暂存
七、核心备忘总结
-
核心流程：本地配置→仓库操作（本地/远程）→分支开发→提交同步；
-
关键原则：未配置身份不可提交，推送前优先拉取，删除仓库/强制推送需谨慎；
-
备忘重点：核心命令无需死记，重点理解操作原理，按需查阅即可。
（注：文档部分内容可能由 AI 生成）