Git 核心操作与企业级协作速查手册

Git 核心操作与企业级协作速查手册

仅代表自己在工作过程中的理解，如有偏差，还望海涵和指出错误

一、基础起步：从零配置到提交

1. 安装与全局配置

Git 不在本地配置密码（认证依赖 SSH Key 或 Token），只需配置提交时显示的身份信息。

# 下载安装（以 Ubuntu 为例，Windows 直接官网下载 exe） sudo apt install git # 配置用户名和邮箱（必做，否则无法 commit） git config --global user.name "你的名字" git config --global user.email "你的邮箱@example.com" # 查看配置 git config --list

2. 核心单人操作流

# 1. 克隆代码库 git clone git@github.com:xxx/xxx.git # 2. 拉取最新代码（编写代码前） git pull # 3. 添加改动到暂存区 git add . # 提交所有改动 git add filename.txt # 提交指定文件 # 4. 提交到本地仓库 git commit -m "feat: 新增了登录功能" # 5. 推送到远程仓库 git push origin <分支名>

3. 远程地址重新配置（HTTPS → SSH）

如果遇到输入密码报错，通常需要把现有的 HTTPS 地址改成 SSH。

# 查看当前远程地址 git remote -v # 修改远程仓库地址 git remote set-url origin git@github.com:你的用户名/你的仓库名.git

二、核心命令辨析：Fetch / Merge / Pull

理解这三个命令的关系，是解决 80% 代码冲突的前提。

git fetch（抓取）

• 极其安全
• 只下载远程最新代码到本地隐藏分支（如origin/master）
• 不会修改当前工作区

git merge（合并）

• 把指定分支的代码合并到当前分支

git pull（拉取）

等价于：

git fetch git merge

• 会自动拉取并尝试合并远程代码

建议：多人协作时优先使用fetch + merge，避免盲目pull造成冲突。

三、企业级多人协作标准流程

企业中严禁多人直接在master或main分支上开发。

1. 开始新功能开发

规则：基于主分支创建自己的独立分支。

# 切到主分支并更新到最新 git checkout master git pull origin master # 创建并切换到自己的开发分支 git checkout -b feat-login-module

2. 每日开发习惯（写代码前的第一件事）

规则：永远先拉取最新代码，避免写完发现全冲突。 如果本地没有未提交代码：

git pull origin master

3. 遇到冲突时的优雅处理（Stash 的妙用）

如果写了一半代码，此时主分支更新，但又不想提交半成品：

# 1. 暂存当前未完成代码 git stash save "暂存未写完的登录逻辑" # 2. 拉取主分支最新代码 git pull origin master # 3. 恢复暂存代码 git stash pop # 4. 若产生冲突，手动解决并继续开发，拿不准的去问对应代码的开发人员

4. 提交本地变更

规则：一次 commit 只做一件事（保持粒度小）。

git add . git commit -m "feat: 完成登录接口校验逻辑"

5. 保持自己分支的最新状态（Fetch & Merge）

功能开发周期较长时，在发起合并请求前必须同步主干。

# 1. 抓取远程最新状态 git fetch origin # 2. 合并远程 master 到当前分支 git merge origin/master # 3. 若有冲突，本地解决后提交

6. 发起合并请求（MR / PR）

git push origin feat-login-module

然后前往 GitLab / GitHub 页面发起：

• Merge Request（GitLab）
• Pull Request（GitHub）

建议：

• 一个完整功能提一次 MR
• 提交前确保同步主干
• 避免几千行代码一次性提交
• 合并后及时删除特性分支

企业协作黄金原则总结

• 不直接在主分支开发
• 写代码前先同步主干
• 使用小粒度 commit
• 优先使用 fetch + merge
• 每个功能一个分支
• 每个功能一次 MR
• 合并后删除分支