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请求,等待项目维护者审查和合并。