GitHub使用教程（小白版）

看一百篇文章不如自己写一篇

第一步：注册和安装

注册GitHub账号

• 访问 GitHub官网。
• 点击右上角的 "Sign up" 按钮。
• 按照提示输入你的邮箱、创建用户名和密码，完成注册。

安装Git

• 访问 Git官网。
• 下载并安装适用于你操作系统的Git。
• 安装完成后，打开命令行（Windows用户可以使用Git Bash）。

第二步：配置Git

1.设置你的用户名和邮箱

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

2.生成SSH密钥并添加到GitHub

• 生成SSH密钥：

  ssh-keygen -t rsa -b 4096 -C "你的邮箱"

按提示操作，生成密钥文件。

• 添加SSH密钥到ssh-agent：

  eval "$(ssh-agent -s)"
  ssh-add ~/.ssh/id_rsa

• 复制SSH公钥：

  cat ~/.ssh/id_rsa.pub

将输出内容复制。

• 登录GitHub，进入Settings > SSH and GPG keys，点击 "New SSH key"，将公钥粘贴进去并保存。

第三步：创建和管理仓库

1.创建一个新的仓库

• 登录GitHub，点击右上角的 "+" 按钮，选择 "New repository"。
• 填写仓库名称，描述（可选），选择公开或私有，点击 "Create repository"。

2.克隆仓库到本地

• 复制仓库的SSH地址。

• 在命令行中，进入你想要保存仓库的目录，然后执行：

  git clone 仓库的SSH地址

例如：

git clone git@github.com:你的用户名/仓库名称.git

3.在本地进行更改并提交

• 进入克隆的仓库目录：

  cd 仓库名称

• 添加文件到仓库（例如创建一个新的文件 example.txt）：

  echo "Hello, GitHub!" > example.txt

• 添加文件到暂存区：

  git add example.txt

• 提交更改

  git commit -m "添加 example.txt 文件"

4.将更改推送到GitHub

git push origin main

第四步：日常使用

1.拉取最新更改

在你进行新的更改之前，确保你有最新的仓库版本：

git pull origin main

2.查看仓库状态

git status

3.查看提交历史

git log

4.创建分支

git branch 新分支名称

5.切换分支

git checkout 新分支名称

6.合并分支

• 切换到你想要合并的主分支（通常是 main）：

  git checkout main

• 执行合并操作：

  git merge 你要合并的分支名称

常见问题和解决方法

SSH连接问题

• 确保你的SSH密钥已经正确添加到GitHub。
• 确保SSH agent正在运行并且你的密钥已经被添加。

冲突解决

• 在合并分支时，如果遇到冲突，需要手动编辑冲突文件，然后执行：

git add 解决冲突的文件
git commit -m "解决冲突"

希望这份教程能帮到你！如果有任何问题，随时问我。