取消 搜索

一次性上传本地项目到 GitHub 完整教程

2026年08月20日 教程指南 216 阅读 0 评论

准备工作

  • 一个 GitHub 账号
  • 本地已安装 Git
  • 本地准备好待上传的项目文件夹

第一步:在 GitHub 上创建新仓库

  1. 登录 GitHub 账户
  2. 点击页面右上角 +号,选择 New repository(新建仓库)
  3. 在 Repository name输入仓库名称(示例:my‑project)
  4. (可选)填写 Description仓库描述
  5. 选择仓库可见性:Public(公开) / Private(私有)
  6. 关键操作:不要勾选 Add a README file、Add .gitignore、Choose a license,保持仓库完全空白
  7. 点击底部绿色按钮 Create repository创建仓库
  8. 创建完成,复制仓库地址,格式:https://github.com/您的用户名/仓库名.git,保留备用

第二步:本地初始化项目

打开终端(Windows 使用 Git Bash),切换到你的项目根目录

cd 您的项目路径

执行命令初始化本地 Git 仓库,并关联 GitHub 远程仓库

git init
git remote add origin https://github.com/您的用户名/仓库名.git

第三步:提交并推送代码到远程

依次执行下面命令:

git add .
git commit -m "首次提交"
git branch -M main
git push -u origin main

命令说明

命令 作用
git add . 将当前目录全部文件添加到暂存区
git commit -m “首次提交” 提交文件,附带提交备注
git branch -M main 把本地分支重命名为 main,对齐 GitHub 默认主分支
git push -u origin main 推送代码到远程 main 分支;‑u 绑定本地与远程分支,后续直接执行 git push 即可

 认证设置(非常重要)

推送代码时弹出账号密码输入框:

  • 用户名:填写你的 GitHub 用户名
  • 密码:不是 GitHub 登录密码,必须使用个人访问令牌 Personal Access Token

生成个人访问令牌步骤

  1. GitHub 右上角头像 → Settings(设置)
  2. 页面拉到最下方,打开 Developer settings(开发者设置)
  3. Personal access tokens→ Tokens (classic)
  4. Generate new token→ Generate new token (classic)
  5. 设置令牌名称(例:my‑token),过期时间可选择 No expiration(永不过期)
  6. 勾选权限:repo(私有仓库完整权限)
  7. 滚动页面到底部,点击 Generate token
  8. 重点:立刻复制保存令牌!仅展示一次,丢失只能重新生成

验证上传成功

推送执行完毕,刷新 GitHub 仓库网页,即可看到本地全部项目文件。

常见问题速查表

报错信息 解决方案
fatal: not a git repository 确认终端处于项目根目录,并且执行过 git init
fatal: remote origin already exists 执行 git remote set-url origin 新仓库地址 更新远程地址
error: failed to push 确认远程仓库为空,不存在 README 等初始化文件;冲突时谨慎执行 git push -u origin main –force
强制推送会覆盖远程仓库内容,谨慎使用
提示密码错误 密码位置粘贴个人访问令牌,不要填登录密码
分享:

评论

暂无评论

暂无评论

快来抢沙发吧~

APP二维码
APP二维码

扫码下载APP

客服二维码
客服二维码

扫码联系客服

客服电话:{{ floatingServicePhone }}

工作时间:{{ floatingServiceHours }}

客服电话:400-123-4567

工作时间:周一至周五 9:00-18:00

公众号二维码
公众号二维码

扫码关注微信公众号

小字
大字
配色
缩小
放大
鼠标
朗读
退出
{{ pendingQQInfo.nickname }}
QQ账号
大写锁定已开启
取消 {{ qqCompleteLoading ? '保存中...' : '完成注册' }}