Git 版本控制常用命令与场景指南

远程协作

撤销与重置

3. Git 一些特殊场景

🎯 场景 1：误删文件，如何恢复？

# 如果已提交过
git checkout <commit-id> -- <file>
# 如果刚 add 但未 commit
git restore --staged <file>
# 先取消暂存
git restore <file>
# 再恢复工作区

🎯 场景 2：提交信息写错了

git commit --amend -m "正确的提交信息"
# 注意：仅限未 push 的最新提交

🎯 场景 3：想把某次提交'移动'到另一个分支

# 方法：使用 cherry-pick
git checkout target-branch
git cherry-pick <commit-id>

🎯 场景 4：解决冲突（Conflict）

1. 手动编辑冲突文件（查找 <<<<<<<, =======, >>>>>>>）
2. 保留需要的代码，删除标记
3. git add <file> 标记冲突已解决
4. 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://<remote-repo-url>.git
cd nova-portal
echo "# nova-portal">> README.md
git add 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://<remote-repo-url>.git
git add .
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://<remote-repo-url>.git
git push -u origin --all
git push -u origin --tags

详解：

# ==============================================
# Git 本地仓库初始化并推送到远程仓库
# 适用场景：本地已有项目文件夹，首次推送到远程空仓库
# ==============================================
# 1. 进入本地已存在的项目文件夹（替换为实际文件夹路径）
cd existing_folder
# 2. 初始化本地 Git 仓库（生成 .git 隐藏目录，存储版本信息）
# 执行后该文件夹成为 Git 可管理的仓库
git init
# 3. 关联远程仓库（origin 是远程仓库的默认别名，可自定义）
# 替换 https://<remote-repo-url>.git 为实际的远程仓库地址
git remote add origin https://<remote-repo-url>.git
# 4. 将本地文件夹下所有文件/文件夹添加到 Git 暂存区
# "." 表示当前目录下所有内容，也可指定具体文件/文件夹
git add .
# 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 pull
git push -u origin main

💡 最佳实践建议

• 小步提交：每次提交只做一件事，信息清晰。
• 分支开发：不要直接在 main/master 上开发。
• Pull Before Push：推送前先拉取，避免冲突。
• .gitignore：合理配置忽略日志、编译产物等。
• 不要 force push 公共分支：除非团队约定且你知道后果。

总结

📚 推荐学习资源：官方 Pro Git 书（免费中文版：https://git-scm.com/book/zh/v2） 可视化练习：https://learngitbranching.js.org

掌握 Git，是每个开发者提升协作效率和代码管理能力的关键一步！