GitHub上传与分支管理指南

本指南整理了GitHub代码上传和分支管理的常用命令，供学习参考

🚀 项目初始化与上传流程

1. 准备工作

  • 在GitHub上创建新仓库
  • 找到要上传的项目所在文件夹

2. 初始化本地仓库

1
git init  # 初始化Git仓库

3. 添加文件到暂存区

1
2
3
git add *  # 添加文件夹里的所有文件
git add .  # 另一种添加所有文件的方式
git add 文件名  # 添加特定文件

4. 提交更改到本地仓库

1
git commit -m "提交信息"  # 提交并添加提交说明

5. 连接远程仓库

1
git remote add origin https://github.com/username/repository.git  # 添加远程仓库

6. 推送到远程仓库

1
2
git push -u origin master  # 推送到远程master分支(首次推送使用-u)
git push origin master    # 后续推送

🌿 分支管理命令

查看分支

1
git branch  # 查看当前本地分支

创建分支

1
git branch 分支名  # 创建新分支

切换分支

1
2
git switch 分支名  # 切换到指定分支
git checkout 分支名  # 旧版本Git使用此命令

创建并切换分支

1
2
git switch -c 分支名  # 创建并切换到新分支
git checkout -b 分支名  # 旧版本Git使用此命令

重命名分支

1
git branch -m 旧分支名 新分支名  # 重命名分支

删除分支

1
2
git branch -d 分支名  # 删除已合并的分支
git branch -D 分支名  # 强制删除未合并的分支

查看仓库状态

1
git status  # 查看当前工作区和暂存区状态

合并分支

1
2
git checkout 目标分支名  # 先切换到目标分支
git merge 源分支名      # 将源分支合并到目标分支

📤 远程分支操作

推送特定分支到远程

1
git push origin 本地分支名  # 推送本地分支到远程同名分支

推送本地分支到远程不同名分支

1
git push origin 本地分支名:远程分支名  # 将本地分支推送到远程不同名分支

查看远程仓库信息

1
git remote -v  # 查看当前配置的远程仓库信息

修改远程仓库URL

1
git remote set-url origin https://github.com/username/new-repository.git  # 修改远程仓库地址

删除并重新添加远程仓库

1
2
git remote remove origin  # 删除已有的远程仓库
git remote add origin https://github.com/username/repository.git  # 重新添加远程仓库

❓ 常见问题解决

解决 “remote origin already exists” 错误

  1. 查看当前远程仓库配置：

    1
    git remote -v

  2. 选择以下方法之一：

    • 修改现有远程仓库URL：

      1
      git remote set-url origin https://github.com/username/new-repository.git

    • 或者删除并重新添加：

      1
      2
      git remote remove origin
      git remote add origin https://github.com/username/new-repository.git

  3. 验证修改是否成功：

    1
    git remote -v

📋 推荐工作流程

  1. 克隆仓库：

    1
    git clone https://github.com/username/repository.git

  2. 创建功能分支：

    1
    git switch -c feature-branch

  3. 开发并提交更改：

    1
    2
    git add .
    git commit -m "实现新功能"

  4. 推送分支：

    1
    git push origin feature-branch

  5. 合并到主分支：

    1
    2
    3
    git switch master
    git merge feature-branch
    git push origin master

🚦 版本回退命令

查看提交历史

1
2
git log  # 查看详细提交历史
git log --oneline  # 查看简洁提交历史

回退到指定版本

1
git reset --hard 提交ID  # 回退到指定版本

撤销最近的提交

1
2
git reset --soft HEAD^  # 撤销最近一次提交，保留更改
git reset --hard HEAD^  # 撤销最近一次提交，不保留更改

📝 注意事项

  • 在提交前，建议创建 .gitignore 文件忽略不必要的文件
  • 定期执行 git pull 更新本地代码，避免冲突
  • 提交信息应简洁明了，说明本次提交的目的
  • 大型项目建议按照功能模块创建不同分支