将本地代码推送到 GitHub 的方法

目录

一、准备工作

二、首次推送（本地代码→新 GitHub 仓库）

三、后续推送（本地代码更新后→GitHub）

四、常见问题及解决

五、总结

---

一、准备工作

1. 安装 Git：从https://git-scm.com/下载并安装，安装后右键文件夹可打开 “Git Bash Here”。
2. 创建 GitHub 仓库：登录 GitHub，点击 “+→New Repository”，填写仓库名（如python_grade），选择公开 / 私有，点击 “Create repository”，复制仓库的 HTTPS/SSH 地址（如https://github.com/你的用户名/仓库名.git）。

二、首次推送（本地代码→新 GitHub 仓库）

1. 打开 Git Bash：在本地代码所在文件夹右键，选择 “Git Bash Here”。
2. 初始化本地 Git 仓库：

   git init

3. 配置 Git 用户信息（首次使用需配置，替换为你的 GitHub 账号）：

   git config --global user.name "你的GitHub用户名" git config --global user.email "你的GitHub注册邮箱"

4. 添加本地代码到暂存区：

   git add . # 点表示添加当前文件夹所有文件

5. 提交代码到本地仓库：

   git commit -m "提交说明（如：初始化项目代码）"

6. 关联 GitHub 远程仓库（替换为你的仓库地址）：

   git remote add origin https://github.com/你的用户名/仓库名.git

7. 推送本地代码到 GitHub：
   • 若本地分支是master、远程默认分支是main（新版 GitHub 默认分支名），需指定分支映射：

     git push -u origin master:main

   • 若本地分支已是main，直接推送：

     git push -u origin main

   （-u参数会关联本地分支与远程分支，后续推送可简化命令）

三、后续推送（本地代码更新后→GitHub）

当本地代码修改后，只需执行以下 3 步：

1. 添加修改到暂存区：

   git add .

2. 提交修改到本地仓库：

   git commit -m "修改说明（如：修复xxx问题）"

3. 推送至 GitHub：

   git push # 因首次推送已关联分支，无需重复指定

四、常见问题及解决

1. 分支不匹配（如本地 master vs 远程 main）：推送时指定分支映射：git push -u origin master:main，或重命名本地分支：

   git branch -m master main # 将本地master重命名为main

2. 推送被拒绝（远程有本地未同步内容）：先拉取远程内容合并，再推送：

   git pull origin main:master --allow-unrelated-histories # 合并无共同历史的分支 git push

3. 权限验证失败：若用 HTTPS 地址，需输入 GitHub 个人访问令牌（替代密码）；若用 SSH 地址，需提前配置 SSH 密钥。

五、总结

本文详细介绍了使用Git和GitHub进行代码版本控制的完整流程：首先安装Git并创建GitHub仓库；其次通过初始化本地仓库、配置用户信息、提交代码并关联远程仓库实现首次推送；随后说明了后续代码更新的简化推送步骤；最后针对分支不匹配、推送拒绝和权限验证等常见问题提供了解决方案。整个教程涵盖了从环境搭建到日常使用的全过程，帮助开发者快速掌握Git与GitHub的基本操作。