GitHub新手使用指南,涵盖了从注册、创建仓库、版本控制基本操作到SSH密钥配置等关键步骤:
第一步:注册与登录
- 访问GitHub官方网站:https://github.com。
- 点击页面右上角的"sign up"按钮开始注册账号。
- 输入有效的电子邮件地址,设置用户名和密码,按照提示完成验证步骤。
第二步:创建仓库
- 登录后,点击右上角的"+"号,然后选择"New repository"。
在新建仓库界面填写相关信息:
- Repository name(仓库名):给你的项目起个名字。
- Description(描述):简短介绍你的项目内容。
- Public/Private(公开/私有):选择是否公开你的代码。
- Initialize this repository with(初始化仓库):可以选择立即添加README文件等初始内容。
- Add .gitignore:选择适用你项目的.gitignore模板,用于忽略不需要版本控制的文件。
- Choose a license(选择许可证):为你的项目选择合适的开源许可证。
- 最后点击右下绿色Create repository创建。
第三步:版本控制操作
克隆已有仓库到本地
- 找到你想要克隆的仓库,点击"Code"按钮获取仓库的HTTPS或SSH地址。
使用终端(如Git Bash)在本地电脑相应目录下执行:
git clone [仓库地址]
创建、切换和合并分支
分支其实就是开发者在同一个项目中创建多个独立的开发线路。每个分支都是一系列提交的集合,这些提交记录了该分支上的代码更改历史。使用分支的主要目的是并行开发:团队成员可以在不同的分支上工作,互不影响,从而实现功能开发、 bug 修复或其他任务的隔离。
创建新分支:
git checkout -b [新分支名]
切换分支:
git checkout [分支名]
将分支内容合并到主分支(如master):
git checkout master git merge [分支名]
提交更改
代码写完之后,如果是新增的文件需要add到暂存区哦,再去进行提交commit,再拉取pull,再推送push。
添加文件变动到暂存区:
git add .
或者针对单个文件:
git add [文件名]
提交更改并附带说明:
git commit -m "本次提交的说明信息"
将本地分支的更改推送到GitHub远程仓库:
git push origin [分支名]
如果是主分支(通常是master或main),则直接:
git push origin master
第四步:配置SSH密钥(非必要)
配置 Git 的 SSH 密钥是为了让你能够在 GitHub、GitLab、Bitbucket 等 Git 仓库托管服务上安全地进行推送和拉取操作,而无需每次都输入用户名和密码。
1. 检查是否已有 SSH 密钥
首先,检查你的用户目录下的 .ssh
文件夹内是否有已存在的公钥(默认文件名为 id_rsa.pub
)。打开终端或命令提示符,输入以下命令:
ls -al ~/.ssh
如果有现成的密钥对并且你希望继续使用它,跳至步骤 4。否则,继续下一步生成新的密钥对。
2. 生成新的 SSH 密钥
运行以下命令来生成一个新的 SSH 密钥对。在这个过程中,你可以选择加密密钥(推荐),并设置一个密码(密语):
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
-t rsa
指定生成 RSA 类型的密钥。-b 4096
设置密钥长度为 4096 位,提高安全性。-C
后面跟的是注释信息,一般填写你的邮箱地址,用于标识这个密钥。
3. 查找公钥
生成密钥对后,公钥文件默认保存为 ~/.ssh/id_rsa.pub
。你可以通过以下命令查看公钥内容:
cat ~/.ssh/id_rsa.pub
4. 添加公钥到 Git 仓库托管服务
接下来,你需要将公钥添加到你的 Git 仓库托管服务账户中。这里以 GitHub 为例:
- 登录你的 GitHub 账户。
- 点击头像,选择“Settings”。
- 在左侧菜单中点击“SSH and GPG keys”。
- 点击页面右上角的“New SSH key”按钮。
- 给密钥起个标题,如“Home Laptop”。
- 将步骤 3 中复制的公钥粘贴到“Key”文本框中。
- 点击“Add SSH key”。
5. 配置 SSH 客户端
为了确保 Git 使用正确的密钥连接到远程仓库,你可能需要在 ~/.ssh/config
文件中配置密钥。如果文件不存在,可以创建一个。以下是一个示例配置,针对 GitHub:
Host github.com
IdentityFile ~/.ssh/id_rsa
6. 测试连接
最后,测试 SSH 连接是否配置成功:
ssh -T git@github.com
如果一切配置正确,你会看到类似“Hello XXX! You've successfully authenticated...”的消息。
完成以上步骤后,你就成功配置了 SSH 密钥,可以开始无密码地与 Git 仓库进行交互了。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。