文章目录
1. Git 概述
什么是 Git？
Git 是一个 分布式版本控制系统（DVCS），由 Linux 之父 Linus Torvalds 于 2005 年创建，用于高效管理代码的变更历史。
核心特点
- 分布式：每个开发者本地都有一份完整的代码仓库（包括完整历史），不依赖中央服务器。
- 快照式存储：Git 不保存“文件差异”，而是对每次提交（commit）保存整个项目的一个快照。
- 分支轻量：创建、切换、合并分支成本极低，鼓励基于分支的开发流程（如 Git Flow、GitHub Flow）。
- 数据完整性：所有内容通过 SHA-1 哈希校验，确保历史不可篡改。
常见协作平台
- GitHub
- GitLab
- Gitee（码云）
- Bitbucket
- GitCode
💡 Git ≠ GitHub！
Git 是工具，GitHub 是托管 Git 仓库的网站。
2. Git 常用命令
基础配置
# ⭐配置用户名和邮箱（关联提交记录，需与Git平台账号一致）git config --global user.name "你的名字"git config --global user.email "你的邮箱@xxx.com"# 查看配置信息git config --list
本地操作
| 命令 | 说明 |
|---|
git init | 初始化一个新的 Git 仓库 |
git clone <url> | 克隆远程仓库到本地 |
git status | 查看工作区状态（哪些文件被修改/未跟踪） |
git add <file> 或 git add . | 将文件添加到暂存区（staging area） |
git commit -m "message" | 提交暂存区内容到本地仓库 |
git log / git log --oneline | 查看提交历史 |
git diff | 查看工作区与暂存区的差异 |
git restore <file> | 撤销工作区修改（Git 2.23+） 旧版用 git checkout -- <file> |
分支管理
| 命令 | 说明 |
|---|
git branch | 列出本地分支 |
git branch <name> | 创建新分支 |
git checkout <branch> 或 git switch <branch> | 切换分支 |
git merge <branch> | 合并指定分支到当前分支 |
git branch -d <name> | 删除已合并的分支 |
git branch -D <name> | 强制删除分支 |
远程协作
| 命令 | 说明 |
|---|
git remote -v | 查看远程仓库地址 |
git fetch | 从远程拉取最新历史（不自动合并） |
git pull | = git fetch + git merge，拉取并合并 |
git push origin <branch> | 推送本地分支到远程 |
git push -u origin <branch> | 首次推送并设置 upstream（后续可直接 git push） |
撤销与重置
| 命令 | 说明 |
|---|
git reset --soft HEAD~1 | 撤销最后一次提交，保留更改在暂存区 |
git reset --mixed HEAD~1（默认） | 撤销提交，保留更改在工作区 |
git reset --hard HEAD~1 | 彻底丢弃最后一次提交及所有更改（慎用！） |
git revert <commit> | 创建一个新提交来“反向”撤销某次提交（安全，适用于已推送的提交） |
3. Git 一些特殊场景
🎯 场景 1：误删文件，如何恢复？
# 如果已提交过git checkout <commit-id> -- <file># 如果刚 add 但未 commitgit restore --staged <file># 先取消暂存git restore <file># 再恢复工作区
🎯 场景 2：提交信息写错了
git commit --amend -m "正确的提交信息"# 注意：仅限未 push 的最新提交
🎯 场景 3：想把某次提交“移动”到另一个分支
# 方法：使用 cherry-pickgit checkout target-branch git cherry-pick <commit-id>
🎯 场景 4：解决冲突（Conflict）
- 手动编辑冲突文件（查找
<<<<<<<, =======, >>>>>>>） - 保留需要的代码，删除标记
git add <file> 标记冲突已解决git commit 完成合并
🎯 场景 5：临时保存工作进度（不提交）
注：恢复 stash 之前，当前分支不可以新增或变更其他文件，否则会恢复失败
git stash # 保存当前修改到“藏匿区”git checkout other-branch # ...做其他事...git stash pop # 恢复之前的工作
🎯 场景 6：回滚已推送到远程的提交
❌ 不要用 reset --hard + push -f（会破坏他人历史）
✅ 正确做法：
git revert <bad-commit-id># 生成一个“反向”提交git push # 安全推送
🎯 场景 7：查看某行代码是谁改的？
git blame <file># 显示每行最后修改的 commit 和作者
🎯 场景 8：清理未跟踪的文件
git clean -n # 预览将被删除的文件git clean -f # 强制删除未跟踪文件git clean -fd # 同时删除目录
🎯 场景 9：推送一个新项目
# 创建一个新仓库git clone https://gitcode.com/novaPortal/nova-portal.git cd nova-portal echo"# nova-portal">> README.md gitadd README.md git commit -m "add README"git branch -m main git push -u origin main # 推送现有的文件cd existing_folder git init git remote add origin https://gitcode.com/xxx/xxx-xxx.git gitadd.git commit -m "Initial commit"git branch -m main git push -u origin main # 推送现有的 Git 仓库cd existing_repo git remote rename origin old-origin git remote add origin https://gitcode.com/novaPortal/nova-portal.git git push -u origin --all git push -u origin --tags
详解：
# ==============================================# Git 本地仓库初始化并推送到 GitCode 远程仓库# 适用场景：本地已有项目文件夹，首次推送到远程空仓库# ==============================================# 1. 进入本地已存在的项目文件夹（替换为实际文件夹路径）cd existing_folder # 2. 初始化本地 Git 仓库（生成 .git 隐藏目录，存储版本信息）# 执行后该文件夹成为 Git 可管理的仓库git init # 3. 关联远程 GitCode 仓库（origin 是远程仓库的默认别名，可自定义）# 替换 https://gitcode.com/xxx/xxx-xxx.git 为实际的远程仓库地址git remote add origin https://gitcode.com/xxx/xxx-xxx.git # 4. 将本地文件夹下所有文件/文件夹添加到 Git 暂存区# "." 表示当前目录下所有内容，也可指定具体文件/文件夹gitadd.# 5. 将暂存区内容提交到本地仓库，备注为 "Initial commit"（首次提交规范备注）# -m 后必须跟提交备注，描述本次提交的内容git commit -m "Initial commit"# 6. 将本地默认分支 master 重命名为 main（符合现代 Git 分支命名规范，GitHub/GitCode 主流默认分支为 main）# 若远程仓库默认分支是 master，可跳过此步骤git branch -m main # 7. 将本地 main 分支推送到远程 origin 仓库，并建立本地与远程分支的关联（-u 等价于 --set-upstream）# 后续推送可简化为 git push，拉取为 git pullgit push -u origin main
💡 最佳实践建议
- 小步提交：每次提交只做一件事，信息清晰。
- 分支开发：不要直接在
main/master 上开发。 - Pull Before Push：推送前先拉取，避免冲突。
- .gitignore：合理配置忽略日志、编译产物等。
- 不要 force push 公共分支：除非团队约定且你知道后果。
总结
| 维度 | 要点 |
|---|
| 本质 | 分布式版本控制系统 |
| 核心对象 | 工作区 → 暂存区 → 本地仓库 → 远程仓库 |
| 灵魂操作 | add / commit / branch / merge / pull / push |
| 高级技巧 | revert / cherry-pick / stash / reflog（救命命令） |
📚 推荐学习资源：官方 Pro Git 书（免费中文版：https://git-scm.com/book/zh/v2）可视化练习：https://learngitbranching.js.org
掌握 Git，是每个开发者提升协作效率和代码管理能力的关键一步！
