手把手教你把代码上传到 GitHub:从零到提交,小白也能秒懂!_github 如何给合作者提交代码到 main 的权限
摘要:想把本地项目同步到 GitHub 却不知从何下手?别担心!本文为你梳理了从安装 Git 到成功推送代码的完整流程,每一步都清晰明了,零基础也能轻松掌握。无论你是刚入门的新手还是想巩固基础的开发者,这篇超详细教程都能帮你快速上手 GitHub 提交操作!
GitHub 是全球开发者协作的基石,而 Git 是连接本地与远程仓库的核心工具。根据 Git 官网 的介绍:
Git 是一个免费、开源的分布式版本控制系统,旨在以极快的速度和高效率管理从小型到超大型的项目。它支持廉价的本地分支、便捷的暂存区和多种工作流,性能远超 Subversion、CVS 等传统 SCM 工具。
这意味着,掌握 Git 不仅是上传代码的“钥匙”,更是提升开发效率的关键技能。
接下来,我们就以一个实际项目为例,一步步将本地代码提交到 GitHub。
🔧 第一步:确认 Git 已安装
打开命令提示符(CMD)、PowerShell 或终端,输入:
git --version
如果返回类似 git version 2.40.1
的信息,说明 Git 已安装。
📌 未安装? 访问 Git官网 下载并安装,安装过程一路“下一步”即可。
📁 第二步:初始化本地仓库
进入你的项目目录(例如 aws_polly
),初始化 Git 仓库:
cd d:\\Projects\\aws_pollygit init
执行后,项目根目录会生成一个隐藏的 .git
文件夹,标志着该目录已成为 Git 仓库。
👤 第三步:配置用户信息
告诉 Git 你是谁,这将用于记录每次提交:
git config --global user.name \"你的GitHub用户名\"git config --global user.email \"你的GitHub邮箱\"
✅ 建议使用与 GitHub 账户绑定的邮箱,确保提交记录能正确关联。
🔗 第四步:关联远程仓库
在 GitHub 上创建一个新仓库(如 aws-polly
),然后将其地址添加为本地仓库的远程连接:
git remote add origin https://github.com/你的GitHub用户名/aws-polly.git
🔁 替换
你的GitHub用户名
为真实用户名。
🔍 第五步:验证远程连接
确认远程仓库是否设置成功:
git remote -v
你应该看到类似输出:
origin https://github.com/你的用户名/aws-polly.git (fetch)origin https://github.com/你的用户名/aws-polly.git (push)
📦 第六步:添加文件到暂存区
将所有文件添加到 Git 的“待提交”列表(暂存区):
git add .
如果你想更精确地控制,可以指定文件:
git add README.md main.py
💾 第七步:提交到本地仓库
为本次更改创建一个提交记录:
git commit -m \"Initial commit - 添加项目基本文件\"
📌 提交信息建议简洁明了,描述清楚本次修改内容。
☁️ 第八步:推送到 GitHub
将本地提交推送到远程仓库的 main
分支(现代 GitHub 默认分支):
git push -u origin main
💡 第一次推送时,系统会提示你输入 GitHub 账号和密码。注意:自 2021 年起,GitHub 不再支持密码登录,需使用 个人访问令牌(Personal Access Token, PAT) 替代。
👉 获取 PAT 方法:
- 登录 GitHub → Settings → Developer settings → Personal access tokens
- 点击 Generate new token,勾选
repo
权限 - 复制生成的 token,在密码输入框中粘贴使用
✅ 第九步:验证是否成功
打开浏览器,访问你的 GitHub 仓库地址:
https://github.com/你的GitHub用户名/aws-polly
如果看到你刚刚提交的文件,恭喜你!代码已成功上传!
🔁 后续提交流程(日常使用)
当你修改代码后,只需重复以下三步:
git add .git commit -m \"更新前端界面样式\"git push
⚠️ 注意:后续推送无需再写
-u origin main
,直接git push
即可。
⚠️ 注意事项(避坑指南)
- 配置
.gitignore
:避免将node_modules
、.env
、日志文件等敏感或冗余内容上传。可参考 gitignore.io 生成模板。 - 使用 PAT 而非密码:GitHub 已禁用密码认证,务必使用个人访问令牌。
- 推送前先拉取:多人协作时,推送前建议先执行
git pull
,防止因版本落后导致冲突。 - 分支管理:大型项目建议使用
feature
分支开发,合并到main
前进行代码审查。
🎉 恭喜你,现在已经掌握了将代码提交到 GitHub 的完整技能!从 git init
到 git push
,每一步都是你迈向专业开发者的坚实脚印。
希望这篇文章能帮你少走弯路,快速上手版本控制。如果你觉得有用,欢迎点赞、收藏、分享给正在学习的小伙伴!
💬 有任何问题?欢迎在评论区留言,我会第一时间回复。一起交流,共同进步!
祝你代码无 Bug,提交顺利,GitHub 绿墙早日达成!💚👨💻
#Git #GitHub #版本控制
本文为原创内容,版权归作者所有,转载需注明出处。