Github仓库上传教程

  1. 1. 基础流程
    1. 1.1. 1. 安装 Git
    2. 1.2. 2. 创建 GitHub 仓库
    3. 1.3. 3. 在本地准备文件夹
    4. 1.4. 4. 打开终端或命令提示符
    5. 1.5. 5. 导航到文件夹
    6. 1.6. 6. 初始化 Git 仓库
    7. 1.7. 7. 添加远程仓库
    8. 1.8. 8. 添加文件
    9. 1.9. 9. 提交更改
    10. 1.10. 10. 推送到 GitHub
  2. 2. 检查当前分支:
    1. 2.1. 创建 main 分支(如果需要)
  3. 3. 创建个人访问令牌的几种方法(这边尝试了第一种)
    1. 3.1. 1. 使用个人访问令牌(PAT)
      1. 3.1.1. 创建个人访问令牌
      2. 3.1.2. 使用个人访问令牌
    2. 3.2. 2. 使用 SSH 密钥
      1. 3.2.1. 生成 SSH 密钥
      2. 3.2.2. 添加 SSH 密钥到 GitHub
      3. 3.2.3. 使用 SSH URL 推送
    3. 3.3. 3. 使用 GitHub CLI
  4. 4. 拉取仓库
    1. 4.1. 克隆远程仓库 :
    2. 4.2. 进入仓库目录 :
    3. 4.3. 拉取更新(可选) :
  5. 5. 强制推送

Github仓库上传教程

基础流程

1. 安装 Git

确保您的计算机上已安装 Git。如果还没有,可以从 Git 官网 下载并安装。

2. 创建 GitHub 仓库

  1. 登录到您的 GitHub 账户。
  2. 点击右上角的 “+” 按钮,选择 “New repository”。
  3. 输入仓库名称和描述,选择公开或私有,然后点击 “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

请将 yourusernameyour-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)

个人访问令牌可以用作密码进行身份验证。您可以按照以下步骤创建一个:

创建个人访问令牌

  1. 登录到您的 GitHub 账户。
  2. 点击右上角的头像,选择 “Settings”。
  3. 在左侧菜单中选择 “Developer settings”。
  4. 点击 “Personal access tokens”。
  5. 点击 “Tokens (classic)”,然后选择 “Generate new token”。
  6. 输入令牌的名称,选择所需的权限(例如,勾选 repo),然后点击 “Generate token”。
  7. 复制生成的令牌(请妥善保存,因为以后无法再次查看)。

使用个人访问令牌

在推送时,当系统提示您输入密码时,使用生成的个人访问令牌代替密码。

2. 使用 SSH 密钥

您也可以使用 SSH 密钥进行身份验证。以下是设置 SSH 密钥的步骤:

生成 SSH 密钥

  1. 打开终端或命令提示符。

  2. 输入以下命令(如果您已经有 SSH 密钥,可以跳过这一步):

    1
    ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

    按照提示完成密钥生成过程。

添加 SSH 密钥到 GitHub

  1. 登录到 GitHub,点击右上角的头像,选择 “Settings”。
  2. 在左侧菜单中选择 “SSH and GPG keys”。
  3. 点击 “New SSH key”。
  4. 在 “Title” 中输入描述,然后在 “Key” 中粘贴您的公钥。您可以使用以下命令查看公钥:
    1
    cat ~/.ssh/id_rsa.pub
  5. 点击 “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
2
3
4
提示:更新被拒绝,因为远程仓库包含您本地尚不存在的提交。这通常是因为另外
提示:一个仓库已向该引用进行了推送。再次推送前,您可能需要先整合远程变更
提示:(如 'git pull ...')。
提示:详见 'git push --help' 中的 'Note about fast-forwards' 小节。

如果出现了这种情况,除了拉取远程仓库更改到本地,更加粗暴的方式是强制推送:

如果您希望强制推送(注意:这将覆盖远程仓库中的更改,慎用),可以使用以下命令:

1
git push origin main --force