从零入门！GitHub仓库创建+本地代码上传超详细教程（新手保姆级）

目录一、前期准备工作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远程仓库四、后续代码更新推送流程五、新手常见报错及解决方案避坑指南问题1fatal: remote origin already exists问题2push 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下载对应版本安装全程默认下一步即可无需修改额外配置验证安装成功打开电脑 CMDWindows/终端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-projectDescription项目描述选填填写项目功能简介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五、新手常见报错及解决方案避坑指南问题1fatal: remote origin already exists原因本地已关联过远程仓库解决删除原有关联重新关联新仓库git remote remove origin问题2push 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熟练掌握这套流程即可实现项目代码云端备份、开源托管是开发者必备的基础技能