准备工作
- 一个 GitHub 账号
- 本地已安装 Git
- 本地准备好待上传的项目文件夹
第一步:在 GitHub 上创建新仓库
- 登录 GitHub 账户
- 点击页面右上角 +号,选择 New repository(新建仓库)
- 在 Repository name输入仓库名称(示例:my‑project)
- (可选)填写 Description仓库描述
- 选择仓库可见性:Public(公开) / Private(私有)
- 关键操作:不要勾选 Add a README file、Add .gitignore、Choose a license,保持仓库完全空白
- 点击底部绿色按钮 Create repository创建仓库
- 创建完成,复制仓库地址,格式: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
生成个人访问令牌步骤
- GitHub 右上角头像 → Settings(设置)
- 页面拉到最下方,打开 Developer settings(开发者设置)
- Personal access tokens→ Tokens (classic)
- Generate new token→ Generate new token (classic)
- 设置令牌名称(例:my‑token),过期时间可选择 No expiration(永不过期)
- 勾选权限:repo(私有仓库完整权限)
- 滚动页面到底部,点击 Generate token
- 重点:立刻复制保存令牌!仅展示一次,丢失只能重新生成
验证上传成功
推送执行完毕,刷新 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 强制推送会覆盖远程仓库内容,谨慎使用 |
| 提示密码错误 | 密码位置粘贴个人访问令牌,不要填登录密码 |
琼ICP备2024037487号-2
琼公网安备46010002000723号
暂无评论
快来抢沙发吧~