Git 常用命令与实战操作指南一、常用 Git 命令速查命令说明示例git clone repository克隆远程仓库到本地git clone https://github.com/username/repo.gitgit add file将文件添加到暂存区git add index.htmlgit commit -m message提交暂存区内容到本地仓库git commit -m Added index.htmlgit push推送本地提交到远程仓库git push origin mastergit pull拉取远程更新并合并到当前分支git pull origin mastergit branch branch-name创建新分支git branch feature-branchgit checkout branch-name切换分支git checkout feature-branchgit merge branch-name合并指定分支到当前分支git merge feature-branchgit status查看工作区和暂存区状态git statusgit log查看提交历史git loggit stash暂存当前未提交的修改git stashgit remote add origin url关联本地仓库与远程仓库git remote add origin https://github.com/username/repo.git 在终端输入git --help可查看更完整的命令帮助。二、终端基础操作目录与文件1. 切换盘符WindowsD: # 切换到 D 盘 cd /d D:\Projects # 切换到 D 盘的 Projects 目录2. 切换目录macOS / Linuxcd/# 切换到根目录cd/Volumes/External# 切换到挂载磁盘3. 列出目录文件WindowsdirmacOS / Linuxls4. 树状图显示目录结构Windows需安装 treetree/tree /fmacOS / Linux自带tree/tree -F5. 返回上级目录cd..cd\# Windows 返回根目录三、完整实战示例从零开始推送 C# 项目到 Gitee步骤 1初始化本地仓库mkdircad-secondary-development-toolcdcad-secondary-development-toolgitinit步骤 2添加文件并提交# 添加所有 .cs 文件gitadd*.cs# 或添加全部文件gitadd.gitcommit-m首次提交 C# 项目代码步骤 3关联远程仓库gitremoteaddorigin https://gitee.com/yourname/cad-secondary-development-tool.git步骤 4拉取远程更新若远程非空gitpull--rebaseorigin master步骤 5推送本地代码gitpush-uorigin master✅ 第一次推送使用-u建立上游关联后续可直接使用git push。四、常用操作完整示例1. 拉取远程最新代码gitpull origin master等价于git fetchgit merge推荐日常使用前先执行。2. 退回提交三种常用方式 回退到上一个提交保留修改gitreset--softHEAD~1撤销 commit但保留暂存区和工作区修改 回退到上一个提交撤销 commit 和 addgitreset--mixedHEAD~1# 默认模式撤销 commit 和 add保留工作区修改 完全回退到指定提交丢弃所有修改gitreset--hardcommit-id彻底回到某个提交慎用会丢失后续修改 回退到远程仓库的某个版本gitreset--hardorigin/master3. 修改最后一次提交内容 修改提交信息gitcommit--amend-m新的提交信息 漏掉了文件补充到上一次提交gitadd忘记的文件.csgitcommit--amend--no-edit# 不修改信息只补充文件 修改更早的提交交互式变基gitrebase-iHEAD~3# 修改最近 3 次提交在打开的编辑器中将pick改为edit保存后修改内容然后执行gitadd.gitcommit--amendgitrebase--continue4. 撤销已推送的提交谨慎操作 方式一回退后强制推送⚠️ 团队协作慎用gitreset--hardHEAD~1gitpush-forigin master 方式二使用 revert 保留历史推荐gitrevert HEAD# 撤销最近一次提交并生成一个新的反向提交gitpush origin master五、常见报错及解决方案❌ 错误 1fatal: unable to auto-detect email address原因未配置 Git 用户信息。解决gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱example.com❌ 错误 2! [rejected] master - master (fetch first)原因远程有本地未获取的新提交。解决gitpull origin master# 若有冲突解决后 add commitgitpush origin master❌ 错误 3! [rejected] master - master (non-fast-forward)原因本地与远程提交历史不一致如曾强制推送或变基。解决合并历史gitpull origin master --allow-unrelated-histories# 解决冲突后提交gitpush origin master⚠️ 也可强制推送不推荐gitpush-forigin master❌ 错误 4fatal: remote origin already exists原因已添加过远程仓库。解决gitremote set-url origin https://新地址.git# 或删除后重新添加gitremote remove origingitremoteaddorigin https://新地址.git❌ 错误 5error: failed to push some refs解决步骤先git pull --rebase origin master解决冲突如有git add .git commitgit push origin master六、实用配置与查看设置/查看用户名和邮箱gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱gitconfig user.name# 查看当前用户名gitconfig user.email# 查看当前邮箱实用配置与查看# 设置用户名和邮箱gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱# 查看当前配置gitconfig user.namegitconfig user.email# 查看 Git 全局配置gitconfig--global--list分支管理完整指南1. 分支基础命令命令说明git branch查看本地所有分支当前分支前有*标记git branch -r查看远程分支git branch -a查看本地和远程所有分支git branch branch-name创建新分支git checkout branch-name切换到指定分支git switch branch-name切换分支Git 2.23 推荐git checkout -b branch-name创建并切换到新分支git switch -c branch-name创建并切换Git 2.23git merge branch-name将指定分支合并到当前分支git branch -d branch-name删除本地分支已合并git branch -D branch-name强制删除本地分支未合并git push origin --delete branch-name删除远程分支git branch -m old-name new-name重命名分支2. 分支管理实战场景 场景一开发新功能标准流程# 1. 从主分支创建功能分支gitcheckout mastergitpull origin master# 确保主分支最新gitcheckout-bfeature/login# 2. 在功能分支上开发并提交gitadd.gitcommit-m完成登录功能开发# 3. 推送功能分支到远程便于协作或备份gitpush-uorigin feature/login# 4. 合并回主分支gitcheckout mastergitpull origin master# 拉取最新主分支gitmerge feature/login# 合并功能分支# 5. 推送更新后的主分支gitpush origin master# 6. 删除已合并的功能分支gitbranch-dfeature/logingitpush origin--deletefeature/login 场景二紧急修复 Bug热修复分支# 1. 从主分支创建热修复分支gitcheckout mastergitcheckout-bhotfix/critical-bug# 2. 修复 Bug 并提交gitadd.gitcommit-m修复登录验证漏洞# 3. 合并到主分支gitcheckout mastergitmerge hotfix/critical-buggitpush origin master# 4. 同步到开发分支如果有gitcheckout developgitmerge hotfix/critical-bug# 5. 删除热修复分支gitbranch-dhotfix/critical-bug 场景三分支冲突解决# 合并时出现冲突gitmerge feature/branch-a# 报错Automatic merge failed; fix conflicts and then commit the result.# 解决步骤gitstatus# 查看冲突文件# 手动编辑冲突文件删除 , , 标记gitadd.# 标记冲突已解决gitcommit-m解决合并冲突gitpush origin master 场景四分支比较与查看# 查看两个分支的差异gitdiffmaster..feature/login# 查看分支提交历史图形化gitlog--graph--oneline--all# 查看哪些分支已合并到当前分支gitbranch--merged# 查看哪些分支未合并到当前分支gitbranch --no-merged3. 分支管理常见报错❌ 错误 1error: The branch xxx is not fully merged原因分支有未合并的提交使用-d删除会被阻止。解决# 确认是否需要合并gitbranch --no-merged# 若确定要丢弃该分支的修改强制删除gitbranch-Dxxx❌ 错误 2fatal: Cannot delete branch xxx checked out at remote原因尝试删除远程分支但该分支正在被某个远程用户使用。解决先切换远程仓库的默认分支或确认无人使用后再删除。❌ 错误 3合并时出现merge conflict解决手动编辑冲突文件 →git add→git commit。标签管理完整指南1. 标签基础命令命令说明git tag查看所有标签git tag -l pattern按模式搜索标签如git tag -l v1.*git tag tag-name创建轻量标签git tag -a tag-name -m message创建附注标签推荐git show tag-name查看标签详细信息git push origin tag-name推送单个标签到远程git push origin --tags推送所有本地标签到远程git tag -d tag-name删除本地标签git push origin --delete tag-name删除远程标签git checkout tag-name切换到标签对应的代码状态2. 标签管理实战场景 场景一发布版本时打标签# 1. 确保在主分支上gitcheckout mastergitpull origin master# 2. 打附注标签推荐gittag-av1.0.0-m发布 1.0.0 正式版# 3. 查看标签gittag# 4. 推送标签到远程gitpush origin v1.0.0# 或推送所有标签gitpush origin--tags 场景二为历史提交打标签# 查看提交历史找到目标 commit-idgitlog--oneline# 为某个历史提交打标签gittag-av0.9.0commit-id-mBeta 版本 场景三基于标签创建分支修复旧版本 Bug# 1. 基于标签创建热修复分支gitcheckout-bhotfix/v1.0.0-fix v1.0.0# 2. 修复 Bug 并提交gitadd.gitcommit-m修复 v1.0.0 版本问题# 3. 打新标签gittag-av1.0.1-m修复补丁版本gitpush origin v1.0.1 场景四删除标签# 删除本地标签gittag-dv1.0.0# 删除远程标签gitpush origin--deletev1.0.0# 或使用旧语法gitpush origin :refs/tags/v1.0.03. 标签管理常见报错❌ 错误 1fatal: tag v1.0.0 already exists原因本地已存在同名标签。解决# 删除本地标签后重新创建gittag-dv1.0.0gittag-av1.0.0-m新的信息gitpush origin v1.0.0--force❌ 错误 2推送标签时报failed to push some refs原因远程已有同名标签。解决# 先删除远程标签gitpush origin--deletev1.0.0# 再推送本地标签gitpush origin v1.0.0七、总结场景推荐命令首次推送项目git init→add .→commit→remote add→push -u日常同步代码git pull→ 修改 →add→commit→push撤销本地提交保留修改git reset --soft HEAD~1撤销本地提交丢弃修改git reset --hard HEAD~1修改最后一次提交git commit --amend撤销已推送提交安全git revert HEAD强制覆盖远程慎用git push -f操作场景推荐命令创建并切换新分支git checkout -b feature/xxx合并分支git merge feature/xxx删除本地分支git branch -d feature/xxx删除远程分支git push origin --delete feature/xxx查看分支图git log --graph --oneline --all打附注标签git tag -a v1.0.0 -m 发布说明推送标签git push origin v1.0.0删除远程标签git push origin --delete v1.0.0撤销本地提交保留修改git reset --soft HEAD~1撤销已推送提交安全git revert HEAD强制覆盖远程慎用git push -f origin master欢迎一起学习交流 我的 Gitee 主页 gitee上传项目到仓库
Git 常用命令与实战操作指南一、常用 Git 命令速查命令说明示例git clone repository克隆远程仓库到本地git clone https://github.com/username/repo.gitgit add file将文件添加到暂存区git add index.htmlgit commit -m message提交暂存区内容到本地仓库git commit -m Added index.htmlgit push推送本地提交到远程仓库git push origin mastergit pull拉取远程更新并合并到当前分支git pull origin mastergit branch branch-name创建新分支git branch feature-branchgit checkout branch-name切换分支git checkout feature-branchgit merge branch-name合并指定分支到当前分支git merge feature-branchgit status查看工作区和暂存区状态git statusgit log查看提交历史git loggit stash暂存当前未提交的修改git stashgit remote add origin url关联本地仓库与远程仓库git remote add origin https://github.com/username/repo.git 在终端输入git --help可查看更完整的命令帮助。二、终端基础操作目录与文件1. 切换盘符WindowsD: # 切换到 D 盘 cd /d D:\Projects # 切换到 D 盘的 Projects 目录2. 切换目录macOS / Linuxcd/# 切换到根目录cd/Volumes/External# 切换到挂载磁盘3. 列出目录文件WindowsdirmacOS / Linuxls4. 树状图显示目录结构Windows需安装 treetree/tree /fmacOS / Linux自带tree/tree -F5. 返回上级目录cd..cd\# Windows 返回根目录三、完整实战示例从零开始推送 C# 项目到 Gitee步骤 1初始化本地仓库mkdircad-secondary-development-toolcdcad-secondary-development-toolgitinit步骤 2添加文件并提交# 添加所有 .cs 文件gitadd*.cs# 或添加全部文件gitadd.gitcommit-m首次提交 C# 项目代码步骤 3关联远程仓库gitremoteaddorigin https://gitee.com/yourname/cad-secondary-development-tool.git步骤 4拉取远程更新若远程非空gitpull--rebaseorigin master步骤 5推送本地代码gitpush-uorigin master✅ 第一次推送使用-u建立上游关联后续可直接使用git push。四、常用操作完整示例1. 拉取远程最新代码gitpull origin master等价于git fetchgit merge推荐日常使用前先执行。2. 退回提交三种常用方式 回退到上一个提交保留修改gitreset--softHEAD~1撤销 commit但保留暂存区和工作区修改 回退到上一个提交撤销 commit 和 addgitreset--mixedHEAD~1# 默认模式撤销 commit 和 add保留工作区修改 完全回退到指定提交丢弃所有修改gitreset--hardcommit-id彻底回到某个提交慎用会丢失后续修改 回退到远程仓库的某个版本gitreset--hardorigin/master3. 修改最后一次提交内容 修改提交信息gitcommit--amend-m新的提交信息 漏掉了文件补充到上一次提交gitadd忘记的文件.csgitcommit--amend--no-edit# 不修改信息只补充文件 修改更早的提交交互式变基gitrebase-iHEAD~3# 修改最近 3 次提交在打开的编辑器中将pick改为edit保存后修改内容然后执行gitadd.gitcommit--amendgitrebase--continue4. 撤销已推送的提交谨慎操作 方式一回退后强制推送⚠️ 团队协作慎用gitreset--hardHEAD~1gitpush-forigin master 方式二使用 revert 保留历史推荐gitrevert HEAD# 撤销最近一次提交并生成一个新的反向提交gitpush origin master五、常见报错及解决方案❌ 错误 1fatal: unable to auto-detect email address原因未配置 Git 用户信息。解决gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱example.com❌ 错误 2! [rejected] master - master (fetch first)原因远程有本地未获取的新提交。解决gitpull origin master# 若有冲突解决后 add commitgitpush origin master❌ 错误 3! [rejected] master - master (non-fast-forward)原因本地与远程提交历史不一致如曾强制推送或变基。解决合并历史gitpull origin master --allow-unrelated-histories# 解决冲突后提交gitpush origin master⚠️ 也可强制推送不推荐gitpush-forigin master❌ 错误 4fatal: remote origin already exists原因已添加过远程仓库。解决gitremote set-url origin https://新地址.git# 或删除后重新添加gitremote remove origingitremoteaddorigin https://新地址.git❌ 错误 5error: failed to push some refs解决步骤先git pull --rebase origin master解决冲突如有git add .git commitgit push origin master六、实用配置与查看设置/查看用户名和邮箱gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱gitconfig user.name# 查看当前用户名gitconfig user.email# 查看当前邮箱实用配置与查看# 设置用户名和邮箱gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱# 查看当前配置gitconfig user.namegitconfig user.email# 查看 Git 全局配置gitconfig--global--list分支管理完整指南1. 分支基础命令命令说明git branch查看本地所有分支当前分支前有*标记git branch -r查看远程分支git branch -a查看本地和远程所有分支git branch branch-name创建新分支git checkout branch-name切换到指定分支git switch branch-name切换分支Git 2.23 推荐git checkout -b branch-name创建并切换到新分支git switch -c branch-name创建并切换Git 2.23git merge branch-name将指定分支合并到当前分支git branch -d branch-name删除本地分支已合并git branch -D branch-name强制删除本地分支未合并git push origin --delete branch-name删除远程分支git branch -m old-name new-name重命名分支2. 分支管理实战场景 场景一开发新功能标准流程# 1. 从主分支创建功能分支gitcheckout mastergitpull origin master# 确保主分支最新gitcheckout-bfeature/login# 2. 在功能分支上开发并提交gitadd.gitcommit-m完成登录功能开发# 3. 推送功能分支到远程便于协作或备份gitpush-uorigin feature/login# 4. 合并回主分支gitcheckout mastergitpull origin master# 拉取最新主分支gitmerge feature/login# 合并功能分支# 5. 推送更新后的主分支gitpush origin master# 6. 删除已合并的功能分支gitbranch-dfeature/logingitpush origin--deletefeature/login 场景二紧急修复 Bug热修复分支# 1. 从主分支创建热修复分支gitcheckout mastergitcheckout-bhotfix/critical-bug# 2. 修复 Bug 并提交gitadd.gitcommit-m修复登录验证漏洞# 3. 合并到主分支gitcheckout mastergitmerge hotfix/critical-buggitpush origin master# 4. 同步到开发分支如果有gitcheckout developgitmerge hotfix/critical-bug# 5. 删除热修复分支gitbranch-dhotfix/critical-bug 场景三分支冲突解决# 合并时出现冲突gitmerge feature/branch-a# 报错Automatic merge failed; fix conflicts and then commit the result.# 解决步骤gitstatus# 查看冲突文件# 手动编辑冲突文件删除 , , 标记gitadd.# 标记冲突已解决gitcommit-m解决合并冲突gitpush origin master 场景四分支比较与查看# 查看两个分支的差异gitdiffmaster..feature/login# 查看分支提交历史图形化gitlog--graph--oneline--all# 查看哪些分支已合并到当前分支gitbranch--merged# 查看哪些分支未合并到当前分支gitbranch --no-merged3. 分支管理常见报错❌ 错误 1error: The branch xxx is not fully merged原因分支有未合并的提交使用-d删除会被阻止。解决# 确认是否需要合并gitbranch --no-merged# 若确定要丢弃该分支的修改强制删除gitbranch-Dxxx❌ 错误 2fatal: Cannot delete branch xxx checked out at remote原因尝试删除远程分支但该分支正在被某个远程用户使用。解决先切换远程仓库的默认分支或确认无人使用后再删除。❌ 错误 3合并时出现merge conflict解决手动编辑冲突文件 →git add→git commit。标签管理完整指南1. 标签基础命令命令说明git tag查看所有标签git tag -l pattern按模式搜索标签如git tag -l v1.*git tag tag-name创建轻量标签git tag -a tag-name -m message创建附注标签推荐git show tag-name查看标签详细信息git push origin tag-name推送单个标签到远程git push origin --tags推送所有本地标签到远程git tag -d tag-name删除本地标签git push origin --delete tag-name删除远程标签git checkout tag-name切换到标签对应的代码状态2. 标签管理实战场景 场景一发布版本时打标签# 1. 确保在主分支上gitcheckout mastergitpull origin master# 2. 打附注标签推荐gittag-av1.0.0-m发布 1.0.0 正式版# 3. 查看标签gittag# 4. 推送标签到远程gitpush origin v1.0.0# 或推送所有标签gitpush origin--tags 场景二为历史提交打标签# 查看提交历史找到目标 commit-idgitlog--oneline# 为某个历史提交打标签gittag-av0.9.0commit-id-mBeta 版本 场景三基于标签创建分支修复旧版本 Bug# 1. 基于标签创建热修复分支gitcheckout-bhotfix/v1.0.0-fix v1.0.0# 2. 修复 Bug 并提交gitadd.gitcommit-m修复 v1.0.0 版本问题# 3. 打新标签gittag-av1.0.1-m修复补丁版本gitpush origin v1.0.1 场景四删除标签# 删除本地标签gittag-dv1.0.0# 删除远程标签gitpush origin--deletev1.0.0# 或使用旧语法gitpush origin :refs/tags/v1.0.03. 标签管理常见报错❌ 错误 1fatal: tag v1.0.0 already exists原因本地已存在同名标签。解决# 删除本地标签后重新创建gittag-dv1.0.0gittag-av1.0.0-m新的信息gitpush origin v1.0.0--force❌ 错误 2推送标签时报failed to push some refs原因远程已有同名标签。解决# 先删除远程标签gitpush origin--deletev1.0.0# 再推送本地标签gitpush origin v1.0.0七、总结场景推荐命令首次推送项目git init→add .→commit→remote add→push -u日常同步代码git pull→ 修改 →add→commit→push撤销本地提交保留修改git reset --soft HEAD~1撤销本地提交丢弃修改git reset --hard HEAD~1修改最后一次提交git commit --amend撤销已推送提交安全git revert HEAD强制覆盖远程慎用git push -f操作场景推荐命令创建并切换新分支git checkout -b feature/xxx合并分支git merge feature/xxx删除本地分支git branch -d feature/xxx删除远程分支git push origin --delete feature/xxx查看分支图git log --graph --oneline --all打附注标签git tag -a v1.0.0 -m 发布说明推送标签git push origin v1.0.0删除远程标签git push origin --delete v1.0.0撤销本地提交保留修改git reset --soft HEAD~1撤销已推送提交安全git revert HEAD强制覆盖远程慎用git push -f origin master欢迎一起学习交流 我的 Gitee 主页