Git 常用命令与分支管理入门:从零掌握版本控制工作流

举报
yd_220055865 发表于 2026/10/23 19:13:13 2026/10/23
【摘要】 本文从零带你掌握 Git 常用命令与分支管理:安装配置、本地仓库基本操作、撤销与版本回退、分支创建合并与冲突解决、远程协作,以及新手避坑清单,帮你快速搭建可直接上手的版本控制工作流。

无论是个人练手项目,还是多人协作开发,版本控制都是绕不开的基本功。Git 作为当今最流行的分布式版本控制系统,已经成为开发者求职与协作的标配。本文从零开始,带你掌握 Git 的常用命令与分支管理,搭建一套可以直接上手的工作流。

一、Git 是什么:先理解三个区

Git 把文件的流转分为三个区域:工作区(Working Directory)、暂存区(Staging Area)和版本库(Repository,即 .git 目录)。

  • 工作区:你实际编辑文件的目录。
  • 暂存区:执行 git add 后,文件快照被放入暂存区。
  • 版本库:执行 git commit 后,暂存区的内容被永久记录为一次提交。

记住"工作区 → 暂存区 → 版本库"这个流程,后面所有命令都围绕它展开。

二、安装与初始配置

各平台安装方式:Linux 可用包管理器(如 sudo apt install git),macOS 可用 brew install git,Windows 从 Git 官网下载安装包。安装完成后先做全局配置:

git --version
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
git config --global init.defaultBranch main
git config --list

其中 user.name 与 user.email 会写入每一次提交,请使用真实的标识;init.defaultBranch 把新仓库的默认分支名设为 main。

三、本地仓库基本操作

git init                  # 在当前目录初始化仓库
git status                # 查看工作区和暂存区状态,最常用的命令
git add 文件名            # 把指定文件加入暂存区
git add .                 # 把当前目录所有改动加入暂存区
git commit -m "提交说明"  # 把暂存区内容提交为一个版本
git log                   # 查看提交历史
git log --oneline --graph --decorate  # 简洁图形化历史

三组 diff 帮你看清差异:

  • git diff:比较工作区与暂存区的差异。
  • git diff --staged:比较暂存区与上一次提交的差异。
  • git diff HEAD:比较工作区与最新提交的差异。

建议:每次提交前先运行 git status 确认改动范围,提交说明用一句话写清"做了什么"。

四、撤销修改与版本回退

这是新手最常用、也最容易踩坑的一组命令,务必分清操作对象:

  • 撤销工作区的修改:git restore 文件名(Git 2.23 及以上版本推荐)。
  • 把文件移出暂存区:git restore --staged 文件名。
  • 回退到上一个版本:git reset --hard HEAD^。
  • 按提交 ID 回退:git reset --hard 提交ID。
git restore hello.py           # 丢弃工作区对 hello.py 的修改
git restore --staged hello.py  # 取消已暂存的 hello.py
git reset --hard HEAD^         # 回到上一个提交(慎用)
git reflog                     # 查看所有操作记录,误删后救命用

注意:--hard 会丢弃工作区和暂存区的所有未提交改动,且无法恢复,使用前务必确认。误删提交后别慌,用 git reflog 找到之前的提交 ID,再 git reset --hard 回去即可。

五、分支管理入门

分支让多人并行开发互不干扰,是 Git 的核心能力。main(或 master)是主分支,新功能一般在独立分支上开发,完成后合并回去。

git branch               # 查看本地分支,* 标记当前分支
git branch feature-login # 新建分支 feature-login
git switch feature-login # 切换到该分支(Git 2.23 及以上)
git switch -c hotfix     # 新建并切换到 hotfix 分支
git merge feature-login  # 切回 main 后,把 feature-login 合并进来
git branch -d feature-login  # 合并完成后删除分支

合并冲突是必经之路:当两个分支改了同一文件的同一位置,merge 会停下来让你手动解决。打开冲突文件,找到 <<<<<<< 标记,保留需要的代码、删除标记后,执行 git add 再 git commit 即可完成合并。

一个简单实用的分支习惯:main 分支永远保持可运行状态;每个功能开一个独立分支;合并前先拉取最新代码或在自己分支上处理好冲突。

六、远程协作:把代码推到远端

git remote add origin 仓库地址  # 关联远程仓库
git push -u origin main         # 首次推送并建立上游关联
git push                        # 后续推送
git clone 仓库地址              # 克隆远程仓库到本地
git pull                        # 拉取并合并远程最新代码
git fetch                       # 只下载不合并,适合先看再合

git pull 本质上是 git fetch + git merge。推送之前先拉取一次,可以显著减少冲突的发生。

七、新手避坑清单

  • 提交前养成 git status 的习惯,避免把调试文件、密钥误提交。
  • 项目根目录尽早编写 .gitignore,忽略依赖目录(如 node_modules)、构建产物和 IDE 配置文件。
  • 不要把大文件、压缩包直接塞进仓库,会让仓库体积迅速失控。
  • 提交信息写清楚"做了什么"而不是"改了哪个文件",方便日后回溯。
  • 已经推送到公共分支(如 main)的提交,不要用 reset --hard 改写历史,会影响所有协作者。

结语

掌握以上命令,就足以应付日常绝大多数开发场景:初始化仓库、提交代码、开分支做功能、合并解决冲突、推送到远程协作。Git 的学习曲线主要集中在前两周,建议边用边查 git --help,把常用命令用成肌肉记忆。之后可以继续学习 rebase、stash、tag 等进阶用法,逐步形成属于自己的工作流。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。