GitHub使用教程（小白版）

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

第一步：注册和安装 

1. 注册GitHub账号  

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

1. 安装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 你要合并的分支名称

常见问题和解决方法

1. SSH连接问题

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

2. 冲突解决

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

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

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