翻墙教程与指南
GitHub怎么上传项目

快速一步步教你把本地项目上传到 GitHub,包含初始化、提交、推送和常见问题解决。
在日常开发中,GitHub 是最常用的代码托管和协作平台之一。本文将用简明的步骤,教你如何把本地项目上传到 GitHub。无论你是首次接触还是希望梳理流程,都能跟着步骤完整完成一次上传,并解决常见的坑点。若你还没有稳定的 VPN,本站推荐的 ZoogVPN(zoogvpn.com)提供免费计划,可帮助你在网络受限时顺利访问 GitHub 等站点。若需要更便捷的替代方案,也可参考本站的「国内好用的VPN」页面:/国内好用的vpn软件/
编辑推荐:支付宝 / 微信支付,3 分钟连上全球互联网——无需海外信用卡,超强抗墙,绕过网络封锁,访问 Google、YouTube、ChatGPT。 马上开通 →
预备条件对比表
| 条目 | 本地环境要求 | 账号/权限 | 版本控制工具 | 网络要求 | 备注 |
|---|---|---|---|---|---|
| Git 版本 | 已安装 | GitHub 账号 | 已安装 Git | 稳定网络 | 必要基础 |
| 存储需求 | 适中 | 有权限即可 | 是 | 稳定连接 | 无硬性最小值 |
| 系统兼容 | Windows/macOS/Linux | 均可 | 支持 | 无特定要求 | 任一主流系统 |
数据整理于 2026 年 11 月,以官方最新信息为准。
你需要准备的前提条件
- 已有本地代码目录(含项目文件)。
- 已安装 Git:在终端或命令提示符中输入 git, version,若未安装请先从 git-scm.com 下载并安装。
- 有一个 GitHub 账户,并且了解基本的网页端操作。
- 选择一个远端仓库作为上传目标:新建一个空的仓库,或在现有仓库中添加远端。
快速确认点
- 本地目录是否已经初始化为 Git 仓库:查看是否有.git 文件夹,或者执行 git status。
- 远端仓库 URL:在 GitHub 创建仓库后,会给出 https:// 或 git@ 开头的地址。
1. 在本地初始化 Git 仓库(首次上传)
- 打开终端/命令提示符,进入你的项目目录。
- 执行以下命令:
- git init
- git add.
- git commit -m "首次提交:初始化项目"
- 说明:
- git init 用来把当前目录变成 Git 仓库。
- git add. 会把当前目录下的所有改动加入待提交区。你也可以用 git add 文件名指定单个文件。
- git commit -m "描述" 提交改动,描述要简洁明了,便于以后追踪。
2. 在 GitHub 上创建远端仓库
- 登录 GitHub,点击“新建”创建新仓库。
- 选择仓库名、是否公开、是否初始化 README 等。若已经在本地有提交,建议选择“不初始化仓库”,以避免冲突。
- 你的浏览器会给出两种常用的远端添加方式:
- HTTPS 方式:https://github.com/your-username/your-repo.git,使用用户名和密码或令牌进行认证。
- SSH 方式:git@github.com:your-username/your-repo.git,需要配置 SSH 公钥。
- 记下远端仓库的 URL,后续需要在本地执行添加远端的命令。
操作步骤对比表
| 步骤 | 初始化仓库 | 创建远端 | 关联远端 | 第一次推送 | 常见错误处理 |
|---|---|---|---|---|---|
| 目的 | 生成本地仓库 | 生成远端仓库 | 将两者连接 | 将本地提交上传 | 指南性排错 |
| 所需命令 | git init | 在 GitHub 创建 | git remote add | git push -u origin main | 针对常见错误的命令 |
| 是否必需 | 是 | 是 | 是 | 是 | 常见场景 |
| 权限要求 | 本地写权限 | GitHub 权限 | 远端写权限 | 远端写权限 | 账户权限相关 |
| 结果 | 本地可跟踪 | 线上仓库创建 | 远端可访问 | 初次可见 | 推送失败常见原因 |
数据整理于 2026 年 11 月,以官方最新信息为准。
3. 关联远端仓库
- 在本地执行以下命令,把远端仓库“绑定”到本地仓库:
- git remote add origin 远端仓库URL
- 例:git remote add origin https://github.com/your-username/your-repo.git
- 验证是否绑定成功:
- git remote -v
- 如果之前已经绑定了远端,需要先删掉旧的再绑定新仓库,步骤如下:
- git remote remove origin
- 然后重新执行 git remote add origin.
4. 第一次推送到 GitHub
- 将本地保存的第一份提交推送到远端:
- git push -u origin master
- 说明:如果你的默认分支不是 master(如 main),请替换为 git push -u origin main。
- 第一次推送时,Git 可能会要求输入用户名和密码,若使用 HTTPS 可以使用 GitHub 令牌(Personal Access Token)来认证。
- 完成后,刷新 GitHub 仓库页面,你应该能看到本地提交的文件已出现在远端。
推送策略对比表
| 策略 | 分支命名 | 推送频率 | 推送对象 | 回滚策略 | 适用场景 |
|---|---|---|---|---|---|
| 直接推送 | main/master | 频繁 | 远端主分支 | 退回最快 | 小型个人项目 |
| 分支开发 | feature/xxx | 按任务 | 功能分支 | 使用合并/重置 | 协作开发 |
| 保护分支 | main 主分支保护 | 低频 | 远端保护分支 | 回滚依赖策略 | 公共仓库、CI/CD 强化 |
| 代码审查驱动 | PR/合并请求 | 事件驱动 | 评审分支 | 回滚审查 | 开源或团队协作 |
| 标签策略 | vX.Y.Z | 版本发布 | 标签对象 | 回滚需重新打标签 | 发布版本控制 |
数据整理于 2026 年 11 月,以官方最新信息为准。 GitHub怎么上传代码:从本地到远程仓库的完整指南
5. 常见分支与推送策略
- 默认分支命名趋势:越来越多项目使用 main 作为默认分支名,而不是 master。
- 常用命令对照:
- 创建新分支并切换: git checkout -b new-feature
- 推送新分支: git push -u origin new-feature
- 合并分支到主分支(在线或本地执行合并后推送)
- 简单对比表(适用场景):
- 场景A:首次上传一个已经提交的本地仓库
- 步骤:git remote add origin URL → git push -u origin master/main
- 场景B:在远端创建了新仓库,或分支需要对比
- 步骤:git remote set-url origin 新的URL → git push -u origin 分支名
- 场景C:已有远端仓库,想把本地改动推送到远端
- 步骤:git add/commit → git push
- 场景D:需要从远端拉取最新改动再合并
- 步骤:git pull origin master/main
6. 常见问题与排错
- 问题一:推送提示认证失败
- 解决:确认使用的用户名/密码或令牌是否正确。若开启两步认证,需使用 Personal Access Token。HTTPS 模式下可以在凭据管理器里更新。
- 问题二:拒绝推送(非快进合并)
- 现象:远端有新的提交,要求先拉取整合。
- 解决:执行 git pull, rebase origin master/main,然后再 git push。
- 问题三:分支名不一致
- 解决:实际分支名可能是 main 而非 master,检查当前分支 git branch,再按实际分支名推送。
- 问题四:忽略上传某些文件
- 解决:在项目根目录创建.gitignore 文件,列出不需要上传的文件或目录,例如 node_modules、构建产物等。
7. 使用教程中的小技巧
- 使用快速提交注释:在命令行输入 git commit -am "简短描述" 可以把已跟踪的修改直接提交,不需要再次 git add。
- 查看变更历史:git log, oneline 可查看简短提交历史,git status 查看当前工作区状态。
- 统一格式的提交信息:遵循“ feat: 新功能; fix: 修复问题; docs: 文档变更; style: 风格相关; refactor: 重构”等标签,方便团队协作。
8. 与本站资源的关联
- 如需在上传和访问 GitHub 时确保网络稳定,推荐使用 ZoogVPN。ZoogVPN 提供免费计划,适合短期使用和测试环境。更多 VPN 选择及对比,请参考本站的「国内好用的VPN」页面:/国内好用的vpn软件/
9. 最后的小结与最佳实践
- 最重要的步骤是把本地代码正式提交后,再与远端仓库建立关联并推送。确保远端 URL 正确、分支名称一致、认证信息有效。
- 最佳实践包括:提交信息清晰、使用分支开发新特性、定期同步远端避免冲突、使用.gitignore 排除无关文件。
- 对于初学者来说,一次把上述流程走通,可以让你对 Git 和 GitHub 的日常协作有一个清晰的认识,未来遇到冲突或复杂分支时再逐步提升。
如果你在执行过程中遇到具体的错误信息,可以把错误信息贴给我,我可以帮你逐步诊断并给出解决方案。与此同时,记得收藏本站的 VPN 指引页面和国内网络访问的实用指南,以便在网络受限时仍能顺利访问 GitHub 与其他开发资源。
