全局配置(首次使用)

1
2
3
4
5
6
# 设置用户名
git config --global user.name "昵称/姓名"
# 设置绑定邮箱
git config --global user.email "邮箱"
# 查看配置是否生效
git config --list

本地初始化仓库

进入项目文件夹,执行git init

代码提交到本地仓库

1
2
3
4
# 所有文件加入暂存区
git add .
# 提交到本地仓库,备注填写本次修改内容
git commit -m "初始化项目"

关联远程仓库

提前在 Gitee/GitHub 建好空仓库,复制仓库地址:

1
2
3
4
# 关联远程仓库,origin 为远程默认名称
git remote add origin 远程仓库地址
# 查看远程关联信息
git remote -v

推送到远程仓库

1
2
3
4
# 首次推送,绑定分支关联
git push -u origin main
# 后续再次推送,直接使用
git push

拉取已有远程仓库到本地(别人的项目)

1
2
3
4
5
# 克隆整个远程仓库到当前目录
git clone 远程仓库地址

# 进入项目文件夹
cd 项目文件夹

日常开发迭代(常用)

开发前:git pull
提交本地:git add . git commit -m "本次功能/修改说明"
推送代码到远程仓库: git push

分支开发(多人协作/功能迭代,规范用法)

主流流程:基于主分支 main 新建功能分支,开发完成后合并回主分支

  1. 确保主分支代码最新
1
2
3
4
# 切换到主分支
git checkout main
# 拉取最新代码
git pull
  1. 创建并切换到功能分支
1
2
# 创建+切换分支(一步到位)
git checkout -b feature/功能名
  1. 分支内正常开发、提交
1
2
3
4
git add .
git commit -m "完成XX功能"
# 如需备份,可推送到远程对应分支
git push -u origin feature/功能名
  1. 功能完成,合并到主分支
1
2
3
4
5
6
# 切回主分支
git checkout main
# 合并功能分支代码
git merge feature/功能名
# 推送合并后的主分支到远程
git push
  1. 清理无用分支(可选)
1
2
# 删除本地功能分支
git branch -d feature/功能名

代码撤销/回退(排错必备)

  1. 仅修改文件,未执行 git add
    丢弃工作区所有改动:
1
git checkout -- .
  1. 已执行 git add,未执行 git commit
    撤销暂存,文件保留修改:
1
git reset HEAD .
  1. commit,想回退到上个版本
    谨慎使用 –hard,会彻底丢弃本地改动
1
git reset --hard HEAD^
  1. 回退到指定历史版本
    先用 git log --oneline 查看版本号,再执行:
1
git reset --hard 目标版本号

补充高频辅助命令

1
2
3
4
5
6
7
8
# 查看文件状态(哪些文件被修改、未提交)
git status

# 查看简洁提交日志
git log --oneline

# 查看本地所有分支
git branch

dev 分支相关操作

  1. 切换到 dev 分支
    git checkout dev

  2. 拉取远程最新代码(避免冲突)
    git pull origin dev

  3. 查看当前文件状态(看看哪些文件被修改/新增)
    git status

  4. 添加所有文件到暂存区
    git add .

  5. 提交代码(记得写有意义的提交信息)
    git commit -m “完成新增查询管理员接口需求”

  6. 推送到远程 dev 分支
    git push origin dev

提交错误分支问题解决

  1. 确认当前分支
    git branch

  2. 切换到目标分支 dev
    git checkout dev

  3. 把 master 上的提交 cherry-pick 过来
    git cherry-pick master

  4. 切回 master,撤销提交
    git checkout master
    git reset --hard HEAD~1

  5. 推送到 dev
    git checkout dev
    git add .
    git commit -m "你的修改"
    git push origin dev