翻墙教程与指南
GitHub怎么上传代码到仓库

系统性教程,教你从本地到 GitHub 的完整上传步骤,包含常见错误排查与常用操作。
要把代码上传到 GitHub,核心目标是把本地代码整理为一个仓库,并将其与远程仓库(GitHub 上的仓库)建立连接,最终把代码推送上去。下面给出一个完整的、可执行的操作指南,方便从零基础到熟练使用。文中如有需要,请参考本站的「国内好用的VPN」页面来保障网络环境畅通:https://your-site-domain/国内好用的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,看到欢迎信息代表配置成功。
2. 创建远程仓库(GitHub)
- 登陆 GitHub,点击右上角的“+”号,选择“New repository”。
- 填写仓库名、描述(可选),选择公开或私有。
- 不勾选“将此仓库初始化并附带一个 README”以便后续直接从本地推送。
- 点击“Create repository”创建远程仓库。
- 看到远程仓库的地址,通常有两种形式:
- 使用 SSH:git@github.com:你的用户名/仓库名.git
- 使用 HTTPS:https://github.com/你的用户名/仓库名.git
- 将远程地址记下,稍后在本地添加远程仓库时需要用到。
创建远程仓库(GitHub)与本地仓库的对比表
| 项目 | 步骤难度 | 需要登录 | 需要网络 | 访问权限范围 | 备注 |
|---|---|---|---|---|---|
| 在 GitHub 创建新仓库 | 低 | 是 | 需要 | 公共/私有 | 选择初始化选项 |
| 本地初始化仓库 | 低 | 否 | 否 | N/A | git init |
| 远程仓库地址获取 | 低 | 是 | 需要 | 公开/私有 | Clone URL |
| 设置远程 origin | 低 | 否 | 否 | N/A | git remote add |
| 推送初始分支 | 中 | 否 | 否 | N/A | git 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/A | N/A | 将目录变为仓库 |
| 将文件加入暂存区 | 低 | 否 | 无 | N/A | 未使用 git add | git 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。
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)等。
