Git 核心命令新手快速上手文档
一、核心命令速查表
| 命令 | 核心作用 | 通俗理解 |
|---|---|---|
| git fetch | 下载远程仓库最新代码（仅同步，不修改本地） | 去远程仓库 “看一眼” 最新内容，复制一份到本地（不碰自己的文件） |
| git pull | 下载远程最新代码并自动合并到当前分支 | 一站式完成「fetch + merge」，直接同步远程最新内容到本地 |
| git merge | 将远程 / 其他分支代码合并到当前分支 | 把 “看一眼” 复制的远程代码，合并到自己正在开发的文件中 |
| git add | 将本地修改加入暂存区（准备提交） | 告诉 Git：“我要提交这些修改，先记下来” |
| git commit | 将暂存区修改提交到本地版本库 | 给本地修改打 “版本标签”，记录修改内容 |
| git push | 将本地提交推送到远程仓库 | 把本地打好标签的修改，上传到远程仓库（如 GitHub/GitLab） |
二、新手必学：完整开发流程（实操步骤）
步骤 1： 同步远程最新代码（2 种方式可选）
开发前先同步远程最新代码，避免和他人修改冲突，两种方式适配不同场景：
方式 1： fetch + merge（推荐，可控性高，新手优先）
分步执行，可先查看远程变更再合并，避免盲合引发冲突：
bash
运行
1.下载远程仓库（origin）所有分支的最新更新（仅下载，不修改本地文件）
git fetch origin
2.将远程 dev 分支的最新代码合并到当前本地分支（解决同步问题）
git merge origin/dev
方式 2： git pull（快捷，一站式同步）
直接执行「fetch + merge」组合操作，适合本地无未提交修改、确认无冲突的场景（如单人开发）：
bash
运行
直接拉取远程 origin 的 dev 分支并合并到当前本地分支
git pull origin dev
若当前分支已关联远程分支，可简化为
git pull
通用关键提醒：
如果合并 / 拉取时提示 “文件被占用 / 冲突”，先关闭占用文件的程序（如编辑器、项目进程）；
日志 / 临时文件冲突可直接删除本地文件（无需版本管理），再重新执行同步命令。
步骤 2： 提交本地修改（add + commit）
开发完成后，提交本地修改到本地版本库：
bash
运行
1.将所有本地修改（新增/修改/删除的文件）加入暂存区
git add -A
2.提交暂存区修改，添加清晰的备注（描述本次改了什么）
git commit -m “修改：删除体征字段 | 新增：日志忽略规则”
关键提醒：
git add -A 是新手首选（覆盖所有修改），也可指定文件：git add src/backend/app.py；
提交备注要清晰（如 “修复：登录接口报错”），方便后续查版本记录。
步骤 3：推送到远程仓库（push）
本地提交完成后，推送到远程仓库让团队可见：
bash
运行
将本地当前分支的提交推送到远程 origin 的 dev 分支
git push origin dev
如果是首次推送该分支，需指定上游分支（后续可直接 git push）
git push -u origin dev
关键提醒：
推送前确保已同步远程最新代码（步骤 1），避免推送冲突；
若提示 “权限不足”，检查远程仓库账号是否有推送权限。