翻墙教程与指南

GitHub怎么上传代码到仓库

白若川··2 min
GitHub怎么上传代码到仓库

系统性教程,教你从本地到 GitHub 的完整上传步骤,包含常见错误排查与常用操作。

要把代码上传到 GitHub,核心目标是把本地代码整理为一个仓库,并将其与远程仓库(GitHub 上的仓库)建立连接,最终把代码推送上去。下面给出一个完整的、可执行的操作指南,方便从零基础到熟练使用。文中如有需要,请参考本站的「国内好用的VPN」页面来保障网络环境畅通:https://your-site-domain/国内好用的vpn软件/

ZoogVPN — 安全、快速的VPN

编辑推荐:支付宝 / 微信支付,3 分钟连上全球互联网——无需海外信用卡,超强抗墙,绕过网络封锁,访问 Google、YouTube、ChatGPT。 马上开通 →

选择 Git 客户端与命令行工具的对比表

选项安装难度学习曲线跨平台性常用命令支持是否官方文档完善
Git 客户端 A中等适中高完整是
Git 客户端 B低低中基本否
Git 命令行高较高高全部是
图形化扩展工具低低中选项多否
Web UI(GitHub)低低高部分命令是

数据整理于 2026 年 11 月,以官方最新信息为准。

1. 准备工作:安装与配置

  • 安装 Git
  • Windows:从 git-scm.com 下载并安装,安装时选择“使用 Git Bash 作为默认命令行工具”。
  • macOS:通常自带 Git,如未安装可用 Homebrew 安装:brew install git。
  • Linux:使用包管理器安装,例如 Ubuntu: sudo apt-get update && sudo apt-get install git。
  • 配置用户名和邮箱
  • git config, global user.name "你的名字"
  • git config, global user.email "你的邮箱@example.com"
  • 验证安装
  • git, version,若显示版本号,则安装成功。
  • 生成 SSH 密钥(推荐用来连接 GitHub)
  • 评估是否已有 SSH:ls -al ~/.ssh
  • 生成:ssh-keygen -t ed25519 -C "你的邮箱@example.com"
  • 将公钥添加到 GitHub:复制 ~/.ssh/id_ed25519.pub 的内容,粘贴到 GitHub 用户设置 > SSH and GPG keys 中。
  • 测试连接:ssh -T git@github.com,看到欢迎信息代表配置成功。
GitHub怎么上传代码到仓库:检查清单

2. 创建远程仓库(GitHub)

  • 登陆 GitHub,点击右上角的“+”号,选择“New repository”。
  • 填写仓库名、描述(可选),选择公开或私有。
  • 不勾选“将此仓库初始化并附带一个 README”以便后续直接从本地推送。
  • 点击“Create repository”创建远程仓库。
  • 看到远程仓库的地址,通常有两种形式:
  • 使用 SSH:git@github.com:你的用户名/仓库名.git
  • 使用 HTTPS:https://github.com/你的用户名/仓库名.git
  • 将远程地址记下,稍后在本地添加远程仓库时需要用到。

创建远程仓库(GitHub)与本地仓库的对比表

项目步骤难度需要登录需要网络访问权限范围备注
在 GitHub 创建新仓库低是需要公共/私有选择初始化选项
本地初始化仓库低否否N/Agit init
远程仓库地址获取低是需要公开/私有Clone URL
设置远程 origin低否否N/Agit remote add
推送初始分支中否否N/Agit push -u origin main

数据整理于 2026 年 11 月,以官方最新信息为准。

3. 将本地代码变成一个 Git 仓库

  • 打开终端(Git Bash/命令行),进入你的代码目录:
  • cd /path/to/your/project
  • 初始化本地仓库
  • git init
  • 将现有文件加入版本控制
  • 将未被忽略的文件加入暂存区:git add.
  • 说明:点号“.” 表示把当前目录下的所有文件(除去.git 目录)都加入暂存区。
  • 第一次提交
  • git commit -m "Initial commit"
  • 这时你的本地还没有远程仓库的连接,接下来建立连接。

4. 关联远程仓库并推送

  • 关联远程仓库
  • 如果你使用 SSH 地址:
  • git remote add origin git@github.com:你的用户名/仓库名.git
  • 如果你使用 HTTPS 地址:
  • git remote add origin https://github.com/你的用户名/仓库名.git
  • 验证远程地址
  • git remote -v,应该看到 origin 指向你的仓库。
  • 第一次推送到远程(建立主分支的远程追踪分支)
  • 对于默认分支名为 main 的情况:
  • git push -u origin main
  • 如果本地还没有 main 分支,先创建并切换到 main:
  • git branch -M main
  • 再执行 git push -u origin main
  • 推送后,刷新 GitHub 仓库页面,应该能看到代码已上传。

将本地代码变成一个 Git 仓库与首次提交的对比表

项目指令难度是否需要初始化提交记录初始提交备注常见错误备注
git init低是无N/AN/A将目录变为仓库
将文件加入暂存区低否无N/A未使用 git addgit add .
第一次提交低否有例如“初次提交”忘记提交信息git commit -m "初次提交"
.gitignore 配置中否无N/A未忽略敏感文件编辑 .gitignore
查看提交日志低否有N/A查错慢git log --oneline

数据整理于 2026 年 11 月,以官方最新信息为准。 GitHub怎么上传项目

5. 常见工作流与分支管理

  • 新建并切换分支
  • git checkout -b feature-xxx
  • 在新分支上工作,完成后提交
  • git add.
  • git commit -m "实现了 xxx 功能"
  • 将分支推送到远程(用于协作)
  • git push -u origin feature-xxx
  • 发起合并请求(Pull Request)
  • 在 GitHub 的仓库页面,切换到你的新分支,点击“Compare & pull request”,填写描述,提交 PR。
  • 经过审核后,合并到主分支(通常是 main)。
  • 冲突处理
  • 当合并时出现冲突,Git 会提示需要手动解决冲突:
  • 打开冲突文件,手动保留需要的代码,删除冲突标记。
  • 添加已解决的文件:git add
  • 提交:git commit -m "解决 XXX 的合并冲突"
  • 冲突解决后再完成合并或继续推进 PR。
GitHub怎么上传代码到仓库:要点总结

6. 常见问题与快速排查

  • 无法连接到 GitHub(认证问题)
  • 确认 SSH 公钥是否正确添加,或改用 HTTPS 方式并在推送时输入凭据。
  • 使用 ssh -T git@github.com 测试连接;若返回 Welcome,则连接正常。
  • 本地仓库没有远程分支
  • 先创建分支后再推送:git checkout -b main,git push -u origin main。
  • 忽略某些文件
  • 使用.gitignore 文件,列出要忽略的文件或目录,如 node_modules/、dist/ 等。
  • 提交历史混乱
  • 使用交互式重写提交历史:
  • git rebase -i HEAD~n(n 为你要整理的提交数量),按需调整提交信息或合并提交。
  • 安全性与备份
  • 不要把密钥、证书、私有信息放入仓库。
  • 定期备份代码和重要分支。可以把关键分支推送到另外一个远程仓库做镜像。

7. 版本对比表(快速对照)

场景 操作要点 常见问题 备注
初始化本地仓库 git init;git add.;git commit -m "初始提交" 忘记添加文件、未创建分支 适用于首次将代码推向 GitHub
关联远程仓库 git remote add origin 远程地址错误、名称冲突 使用 SSH 安全性更高,HTTPS 简便
第一次推送 git push -u origin main 分支名错误、未创建分支 如果默认分支不是 main,替换为你的分支名
新建并推送分支 git checkout -b feature-xxx;git push -u origin feature-xxx 分支未推送导致他人看不到 善用 PR 进行代码评审
解决冲突 手动修改文件;git add;git commit 冲突标记未清除 冲突解决后继续合并/推送

8. 小结与建议

  • 以“清晰的提交信息”为原则,逐步提交,避免一次性提交大量改动,方便回溯和协作。
  • 尽量使用分支开展新功能、修复或改进,最终通过 Pull Request 合并到主分支,确保主分支稳定。
  • 使用 SSH 连接 GitHub 能提高安全性与稳定性。如果网络环境较差,可以通过本站的 VPN 服务保障稳定连接:https://your-site-domain/国内好用的vpn软件/
  • 随着项目成长,定期整理分支,清理不再需要的远程分支,保持仓库整洁。

如果你愿意,我可以根据你的操作系统和具体项目结构,给出一份定制化的命令清单,确保你一步到位地完成上传。也可以进一步讲解如何在无图形界面的环境下使用 Git,或解释一些进阶用法,如子模块、工作流模型(如 GitFlow)等。