我来教你如何将本地 Git 仓库推送到 GitHub。
完整步骤
第一步:在 GitHub 上创建仓库
- 登录 GitHub (https://github.com)
- 点击右上角 "+" -> "New repository"
- 填写仓库名称(例如:my-project)
- 选择 Public 或 Private
- 不要勾选 "Initialize this repository with a README"
- 点击 "Create repository"
第二步:连接本地仓库到 GitHub
bash
# 1. 进入你的项目文件夹
cd my-project
# 2. 如果还没初始化 git,先初始化
git init
# 3. 添加远程仓库地址
git remote add origin https://github.com/你的用户名/仓库名.git
# 例如:
# git remote add origin https://github.com/zhangsan/my-project.git
# 4. 查看远程仓库是否添加成功
git remote -v
第三步:推送代码到 GitHub
bash
# 1. 添加所有文件
git add .
# 2. 提交
git commit -m "first commit"
# 3. 推送到 GitHub(首次推送)
git push -u origin main
# 或者如果分支是 master
git push -u origin master
完整示例
bash
# 假设你已经有一个项目文件夹
cd ~/my-work
# 初始化 git
git init
# 配置用户信息(如果之前没配置)
git config user.name "Zhang San"
git config user.email "zhangsan@example.com"
# 添加远程仓库
git remote add origin https://github.com/zhangsan/my-work.git
# 添加文件
git add .
# 提交
git commit -m "Initial commit"
# 推送(首次)
git push -u origin main
常见问题解决
问题1:分支名称不匹配
如果 GitHub 默认分支是 main,但本地是 master:
bash
# 重命名本地分支
git branch -M main
# 然后推送
git push -u origin main
问题2:需要认证
GitHub 现在要求使用 Personal Access Token (PAT) 而不是密码:
生成 Token:
- GitHub -> Settings -> Developer settings -> Personal access tokens -> Tokens (classic)
- Generate new token (classic)
- 勾选
repo权限 - 生成并复制 token(只显示一次)
使用 Token:
bash
# 推送时会提示输入用户名和密码
# 用户名:你的 GitHub 用户名
# 密码:粘贴你的 Personal Access Token
问题3:使用 SSH 代替 HTTPS
bash
# 1. 生成 SSH 密钥(如果没有)
ssh-keygen -t ed25519 -C "your.email@example.com"
# 2. 复制公钥
cat ~/.ssh/id_ed25519.pub
# 3. 添加到 GitHub: Settings -> SSH and GPG keys -> New SSH key
# 4. 使用 SSH 地址添加远程仓库
git remote add origin git@github.com:用户名/仓库名.git
# 或修改已有的远程地址
git remote set-url origin git@github.com:用户名/仓库名.git
后续推送
首次推送后,以后只需要:
bash
git add .
git commit -m "更新说明"
git push
其他常用命令
bash
# 查看远程仓库
git remote -v
# 删除远程仓库连接
git remote remove origin
# 修改远程仓库地址
git remote set-url origin <新地址>
# 拉取远程更新
git pull
# 克隆你自己的仓库
git clone https://github.com/用户名/仓库名.git