Github仓库上传教程
基础流程
1. 安装 Git
确保您的计算机上已安装 Git。如果还没有,可以从 Git 官网 下载并安装。
2. 创建 GitHub 仓库
- 登录到您的 GitHub 账户。
- 点击右上角的 “+” 按钮,选择 “New repository”。
- 输入仓库名称和描述,选择公开或私有,然后点击 “Create repository”。
3. 在本地准备文件夹
将您要上传的文件夹准备好,确保它包含您想要上传的所有子文件夹和文件。
4. 打开终端或命令提示符
根据您的操作系统,打开终端(Linux/Mac)或命令提示符(Windows)。
5. 导航到文件夹
使用 cd
命令导航到包含您要上传的文件夹。例如:
1 | cd /path/to/your/folder |
6. 初始化 Git 仓库
在文件夹中初始化一个新的 Git 仓库:
1 | git init |
7. 添加远程仓库
将您在 GitHub 上创建的仓库添加为远程仓库:
1 | git remote add origin https://github.com/yourusername/your-repo-name.git |
请将 yourusername
和 your-repo-name
替换为您的 GitHub 用户名和仓库名称。
8. 添加文件
将所有文件添加到 Git 暂存区:
1 | git add . |
9. 提交更改
提交您的更改:
1 | git commit -m "Initial commit" |
10. 推送到 GitHub
将本地仓库的内容推送到 GitHub:
1 | git push -u origin master |
检查当前分支:
首先,您可以检查当前的分支名称。运行以下命令:
1 | git branch |
如果您看到的是 master
而不是 main
,那么您需要将推送命令中的 main
替换为 master
。
创建 main
分支(如果需要)
如果您希望使用 main
作为主分支,可以创建一个新的 main
分支并切换到它:
1 | git checkout -b main |
然后,您可以将更改推送到 main
分支:
1 | git push -u origin main |
创建个人访问令牌的几种方法(这边尝试了第一种)
1. 使用个人访问令牌(PAT)
个人访问令牌可以用作密码进行身份验证。您可以按照以下步骤创建一个:
创建个人访问令牌
- 登录到您的 GitHub 账户。
- 点击右上角的头像,选择 “Settings”。
- 在左侧菜单中选择 “Developer settings”。
- 点击 “Personal access tokens”。
- 点击 “Tokens (classic)”,然后选择 “Generate new token”。
- 输入令牌的名称,选择所需的权限(例如,勾选
repo
),然后点击 “Generate token”。 - 复制生成的令牌(请妥善保存,因为以后无法再次查看)。
使用个人访问令牌
在推送时,当系统提示您输入密码时,使用生成的个人访问令牌代替密码。
2. 使用 SSH 密钥
您也可以使用 SSH 密钥进行身份验证。以下是设置 SSH 密钥的步骤:
生成 SSH 密钥
打开终端或命令提示符。
输入以下命令(如果您已经有 SSH 密钥,可以跳过这一步):
1
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
按照提示完成密钥生成过程。
添加 SSH 密钥到 GitHub
- 登录到 GitHub,点击右上角的头像,选择 “Settings”。
- 在左侧菜单中选择 “SSH and GPG keys”。
- 点击 “New SSH key”。
- 在 “Title” 中输入描述,然后在 “Key” 中粘贴您的公钥。您可以使用以下命令查看公钥:
1
cat ~/.ssh/id_rsa.pub
- 点击 “Add SSH key”。
使用 SSH URL 推送
在推送代码之前,您需要将远程仓库的 URL 更改为 SSH 格式:
1 | git remote set-url origin git@github.com:yourusername/your-repo-name.git |
然后再尝试推送:
1 | git push -u origin master |
3. 使用 GitHub CLI
如果您安装了 GitHub CLI,可以使用以下命令进行身份验证:
1 | gh auth login |
然后按照提示进行操作。
拉取仓库
克隆远程仓库 :
使用 git clone
命令将远程仓库克隆到本地。命令格式如下:
1 | git clone https://github.com/用户名/仓库名.git |
进入仓库目录 :
克隆后,进入该仓库的本地目录:
1 | cd example-repo |
拉取更新(可选) :
如果您已经有仓库的本地副本,并且只想拉取最新的更新,可以使用:
1 | git pull |
这样可以从远程仓库拉取最新的更改。
强制推送
1 | 提示:更新被拒绝,因为远程仓库包含您本地尚不存在的提交。这通常是因为另外 |
如果出现了这种情况,除了拉取远程仓库更改到本地,更加粗暴的方式是强制推送:
如果您希望强制推送(注意:这将覆盖远程仓库中的更改,慎用),可以使用以下命令:
1 | git push origin main --force |