GitHub新手使用指南，涵盖了从注册、创建仓库、版本控制基本操作到SSH密钥配置等关键步骤：

第一步：注册与登录

  1. 访问GitHub官方网站：https://github.com。
  2. 点击页面右上角的”sign up”按钮开始注册账号。
  3. 输入有效的电子邮件地址，设置用户名和密码，按照提示完成验证步骤。

第二步：创建仓库

  1. 登录后，点击右上角的”+“号，然后选择”New repository”。
  2. 在新建仓库界面填写相关信息：
    • Repository name（仓库名）：给你的项目起个名字。
    • Description（描述）：简短介绍你的项目内容。
    • Public/Private（公开/私有）：选择是否公开你的代码。
    • Initialize this repository with（初始化仓库）：可以选择立即添加README文件等初始内容。
    • Add .gitignore：选择适用你项目的.gitignore模板，用于忽略不需要版本控制的文件。
    • Choose a license（选择许可证）：为你的项目选择合适的开源许可证。

第三步：版本控制操作

克隆已有仓库到本地
  1. 找到你想要克隆的仓库，点击”Code”按钮获取仓库的HTTPS或SSH地址。
  2. 使用终端（如Git Bash）在本地电脑相应目录下执行：
    git clone [仓库地址]
创建、切换和合并分支
  1. 创建新分支：
    git checkout -b [新分支名]
  2. 切换分支：
    git checkout [分支名]
  3. 将分支内容合并到主分支（如master）：
    git checkout mastergit merge [分支名]
提交更改
  1. 添加文件变动到暂存区：
    git add .

    或者针对单个文件：

    git add [文件名]
  2. 提交更改并附带说明：
    git commit -m "本次提交的说明信息"
  3. 将本地分支的更改推送到GitHub远程仓库：
    git push origin [分支名]

    如果是主分支（通常是master或main），则直接：

    git push origin master

第四步：配置SSH密钥

  1. 在本地生成SSH密钥：

    ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"

    一路回车，会在默认路径下生成一对公钥和私钥文件。

  2. 查看并复制公钥内容：

    cat ~/.ssh/id_rsa.pub

    复制显示的公钥文本。

  3. 在GitHub个人设置（Settings）中找到”SSH and GPG keys”部分，点击”New SSH key”，输入标题，将公钥内容粘贴到”Key”框内，然后保存。

第五步：日常协作与Pull Request

  1. 当你需要向他人项目贡献代码时，需要fork原始仓库到自己的账户下，然后clone fork后的仓库。
  2. 修改代码后，通过git push推送到你自己的仓库。
  3. 在GitHub网站上对比原仓库，点击”New pull request”发起PR请求，等待项目维护者审查和合并。