目录
一、前期准备工作
1.1 注册GitHub账号（免费）
1.2 本地安装Git工具
1.3 配置全局Git用户名和邮箱
二、GitHub网页端创建远程仓库
三、本地项目上传至GitHub远程仓库（核心步骤）
3.1 进入本地项目目录
3.2 初始化本地Git仓库
3.3 将本地代码加入暂存区
3.4 提交代码到本地仓库
3.5 关联GitHub远程仓库
3.6 拉取远程仓库文件（必做！避坑关键）
3.7 推送本地代码到GitHub远程仓库
四、后续代码更新推送流程
五、新手常见报错及解决方案（避坑指南）
问题1：fatal: remote origin already exists
问题2：push error: src refspec main does not match any
问题3：权限不足、登录凭证报错
问题4：分支冲突推送失败
六、补充：.gitignore 文件配置（实用技巧）
七、总结
从零入门！GitHub仓库创建+本地代码上传超详细教程（新手保姆级）
✨前言
对于编程开发者而言，GitHub 是全球最大的开源代码托管平台，无论是日常代码备份、项目开源、简历加分还是团队协作，都离不开 GitHub 仓库的基础使用。
很多新手刚接触开发时，都会卡在GitHub账号注册、仓库创建、本地代码推送这一步，频繁出现命令报错、推送失败、权限不足等问题。
本文将从零开始，手把手带你完成GitHub账号申请→Git环境配置→远程仓库创建→本地项目代码上传→后续代码更新推送全流程，全程无跳步，适配 Windows/Mac 系统，新手看完直接上手！
📌适用人群：编程新手、初次使用GitHub、不会本地代码上传远程仓库的开发者
📌实现效果：将本地任意项目（Java/Python/前端/脚本等）完整上传至GitHub远程仓库
一、前期准备工作
在操作之前，我们需要完成两个基础准备：注册GitHub账号、本地安装Git工具，这是所有操作的前提。
1.1 注册GitHub账号（免费）
GitHub 提供免费账号，完全满足个人项目托管需求，注册步骤如下：
访问 GitHub 官网：GitHub · Change is constant. GitHub keeps you ahead. · GitHub
点击首页Sign up进入注册页面，依次填写：邮箱、密码、用户名
完成人机验证，根据提示完成邮箱验证（登录注册邮箱，点击GitHub发送的验证链接）
验证通过后，即可登录GitHub个人主页，免费账号默认支持创建无限个公开仓库
💡 小提示：注册时建议使用常用邮箱，后续代码提交、权限验证、密码重置都需要依赖该邮箱。
1.2 本地安装Git工具
GitHub 代码上传、提交、推送都需要依赖Git版本控制工具，电脑未安装则无法执行任何命令。
Git官网下载：Redirecting…，根据自己的系统（Windows/Mac/Linux）下载对应版本
安装全程默认下一步即可，无需修改额外配置
验证安装成功：打开电脑 CMD（Windows）/终端（Mac），输入以下命令，输出版本号即安装成功
git --version1.3 配置全局Git用户名和邮箱
首次使用Git必须配置全局身份信息，否则后续代码提交会报错，用户名和邮箱必须和GitHub注册信息一致。
终端依次输入以下两条命令（替换为自己的GitHub用户名、注册邮箱）：
# 配置全局用户名 git config --global user.name "你的GitHub用户名" # 配置全局邮箱 git config --global user.email "你的GitHub注册邮箱"验证配置是否成功：输入以下命令查看配置信息
git config --global --list二、GitHub网页端创建远程仓库
本地环境配置完成后，我们需要在GitHub官网创建一个远程空仓库，用于存放本地项目代码，步骤极简：
登录GitHub个人主页，点击页面右上角「+」号，选择New repository（新建仓库）
进入仓库配置页面，填写核心信息（重点！新手严格按照以下配置）：
Repository name（仓库名）：必填，建议英文小写+短横线，和本地项目文件夹名一致（如 my-demo-project）
Description（项目描述）：选填，填写项目功能简介
Public/Private：新手选择Public（免费公开仓库，无限使用；Private私有仓库免费版有数量限制）
Add a README file：必须勾选（自动生成项目说明文件，避免空仓库推送报错）
Add .gitignore：选择对应项目语言（如Python、Java、Node，新手可先选None，后续手动配置）
Choose a license：选 MIT 开源协议（通用开源协议，保护代码版权）
点击页面底部Create repository，远程仓库创建完成！
💡 核心注意点：新手一定要勾选 README 文件！如果创建纯空仓库，本地推送代码会出现分支冲突、权限报错等问题。
三、本地项目上传至GitHub远程仓库（核心步骤）
这是全文最核心的步骤，分为初始化本地仓库→关联远程仓库→提交代码→推送代码四步，所有命令复制即用。
3.1 进入本地项目目录
打开终端，通过 cd 命令切换到你的本地项目根目录（所有代码文件所在的文件夹）
# 示例（Windows/Mac通用） cd /Users/xxx/Desktop/my-demo-project3.2 初始化本地Git仓库
在项目根目录下，执行命令初始化Git仓库，执行后文件夹会生成隐藏的 .git 文件夹（版本控制核心文件，勿删除）
git init3.3 将本地代码加入暂存区
将项目中所有文件、文件夹添加到Git暂存区，等待提交
# 添加所有文件（推荐新手使用） git add . # 单独添加指定文件（按需使用） # git add 文件名3.4 提交代码到本地仓库
将暂存区代码正式提交到本地仓库，引号内为提交备注（自定义，说明本次提交内容）
git commit -m "首次提交：上传完整项目代码"3.5 关联GitHub远程仓库
回到刚才创建的GitHub远程仓库页面，复制仓库的HTTPS地址（新手优先用HTTPS，无需配置SSH密钥）
执行以下命令，关联本地项目与远程仓库：
# 替换为你自己的仓库HTTPS地址 git remote add origin https://github.com/用户名/仓库名.git验证关联是否成功：执行命令查看远程仓库地址
git remote -v3.6 拉取远程仓库文件（必做！避坑关键）
因为远程仓库创建时生成了 README、LICENSE 文件，本地仓库为空，直接推送会报错，需要先拉取远程文件同步：
git pull origin main3.7 推送本地代码到GitHub远程仓库
最后执行推送命令，将本地所有代码上传到GitHub仓库
git push -u origin main执行完成后，刷新GitHub仓库页面，即可看到本地所有代码已经成功上传！
四、后续代码更新推送流程
首次上传完成后，后续修改本地代码、新增文件，无需重复初始化仓库，只需执行简单三步即可更新远程代码：
# 1. 添加修改文件 git add . # 2. 提交更新（备注修改内容） git commit -m "更新：修复bug/新增功能" # 3. 推送到远程仓库 git push五、新手常见报错及解决方案（避坑指南）
问题1：fatal: remote origin already exists
原因：本地已关联过远程仓库
解决：删除原有关联，重新关联新仓库
git remote remove origin问题2：push error: src refspec main does not match any
原因：没有执行 git add 或 git commit，无代码可推送
解决：重新执行 add、commit 命令
问题3：权限不足、登录凭证报错
原因：HTTPS凭证过期或未缓存
解决：缓存本地凭证，后续无需重复输入账号密码
git config --global credential.helper store问题4：分支冲突推送失败
原因：远程仓库和本地仓库文件不一致
解决：先拉取远程代码再推送
git pull origin main --allow-unrelated-histories六、补充：.gitignore 文件配置（实用技巧）
项目中很多文件不需要上传（如日志、依赖包、缓存文件、系统文件），可以通过.gitignore文件忽略：
在项目根目录新建.gitignore文件，写入需要忽略的文件格式，示例通用配置：
# 系统文件 .DS_Store Thumbs.db # 依赖目录 node_modules venv target # 日志文件 *.log # 编译文件 *.class *.pyc七、总结
本文完整覆盖了 GitHub 从账号注册→环境配置→仓库创建→代码上传→后续更新→报错解决的全流程，核心核心命令汇总：
全局配置：git config 用户名/邮箱
本地初始化：git init
代码暂存：git add .
本地提交：git commit -m "备注"
远程关联：git remote add origin 仓库地址
同步推送：git pull + git push
熟练掌握这套流程，即可实现项目代码云端备份、开源托管，是开发者必备的基础技能！