> 技术文档 > 手把手教你把代码上传到 GitHub:从零到提交,小白也能秒懂!_github 如何给合作者提交代码到 main 的权限

手把手教你把代码上传到 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 方法:

  1. 登录 GitHub → Settings → Developer settings → Personal access tokens
  2. 点击 Generate new token,勾选 repo 权限
  3. 复制生成的 token,在密码输入框中粘贴使用

✅ 第九步:验证是否成功

打开浏览器,访问你的 GitHub 仓库地址:

https://github.com/你的GitHub用户名/aws-polly

如果看到你刚刚提交的文件,恭喜你!代码已成功上传!


🔁 后续提交流程(日常使用)

当你修改代码后,只需重复以下三步:

git add .git commit -m \"更新前端界面样式\"git push

⚠️ 注意:后续推送无需再写 -u origin main,直接 git push 即可。


⚠️ 注意事项(避坑指南)

  1. 配置 .gitignore:避免将 node_modules.env、日志文件等敏感或冗余内容上传。可参考 gitignore.io 生成模板。
  2. 使用 PAT 而非密码:GitHub 已禁用密码认证,务必使用个人访问令牌。
  3. 推送前先拉取:多人协作时,推送前建议先执行 git pull,防止因版本落后导致冲突。
  4. 分支管理:大型项目建议使用 feature 分支开发,合并到 main 前进行代码审查。

🎉 恭喜你,现在已经掌握了将代码提交到 GitHub 的完整技能!从 git initgit push,每一步都是你迈向专业开发者的坚实脚印。

希望这篇文章能帮你少走弯路,快速上手版本控制。如果你觉得有用,欢迎点赞、收藏、分享给正在学习的小伙伴!

💬 有任何问题?欢迎在评论区留言,我会第一时间回复。一起交流,共同进步!

祝你代码无 Bug,提交顺利,GitHub 绿墙早日达成!💚👨‍💻


#Git #GitHub #版本控制


本文为原创内容,版权归作者所有,转载需注明出处。