使用 Git 和 GitHub 进行版本控制和协作开发涉及多个步骤,从初始配置到日常使用。以下是详细的指南,包括配置 SSH 公私钥、本地和远程仓库操作的基本步骤。
一、初始配置
1.1 安装 Git
首先,您需要安装 Git。可以从 Git 官方网站 下载并安装适用于您操作系统的版本。
1.2 配置用户名和邮箱
安装完成后,配置 Git 的用户名和邮箱,这些信息会包含在每次提交中。
git config --global user.name "Your Name" git config --global user.email "your.email@example.com"
1.3 生成 SSH 密钥对
使用 SSH 密钥对进行身份验证,以便与 GitHub 进行安全通信。
生成新的 SSH 密钥对:
ssh-keygen -t rsa -b 4096 -C "your.email@example.com"
按提示操作,通常可以直接按 Enter 使用默认路径和文件名。为密钥设置一个强密码。
1.4 添加 SSH 密钥到 GitHub
将生成的公钥添加到您的 GitHub 账户中。
复制公钥到剪贴板:
cat ~/.ssh/id_rsa.pub | clip # Windows cat ~/.ssh/id_rsa.pub | pbcopy # macOS cat ~/.ssh/id_rsa.pub # Linux,手动复制输出内容
打开 GitHub 网站,进入
Settings
->SSH and GPG keys
,点击New SSH key
,将公钥粘贴到对应的文本框中。
1.5 测试 SSH 连接
验证是否成功配置:
ssh -T git@github.com
看到欢迎信息即表示成功。
二、本地仓库操作
2.1 克隆远程仓库
从 GitHub 克隆仓库到本地:
git clone git@github.com:YourUsername/YourRepository.git cd YourRepository
2.2 创建新分支
开发新功能或修复 bug 时,通常会创建一个新的分支:
git checkout -b new-feature
2.3 添加和提交更改
编辑文件后,将更改添加到暂存区,然后提交:
git add . git commit -m "Add new feature"
2.4 推送更改到远程仓库
将本地分支推送到远程仓库:
git push origin new-feature
2.5 合并分支
完成开发后,合并分支到主分支(通常是 main
或 master
):
git checkout main git merge new-feature git push origin main
三、远程仓库操作
3.1 查看远程仓库
查看已配置的远程仓库:
git remote -v
3.2 添加远程仓库
如果需要添加新的远程仓库:
git remote add origin git@github.com:YourUsername/YourRepository.git
3.3 拉取最新更改
从远程仓库拉取最新的更改到本地:
git pull origin main
四、仓库增删改查
4.1 添加文件
将新文件添加到仓库:
git add newfile.txt
4.2 删除文件
从仓库中删除文件:
git rm oldfile.txt git commit -m "Remove oldfile.txt"
4.3 移动或重命名文件
移动或重命名文件:
git mv oldname.txt newname.txt git commit -m "Rename oldname.txt to newname.txt"
4.4 查看提交历史
查看提交历史:
git log
五、常用 Git 命令
5.1 查看状态
查看工作目录的当前状态:
git status
5.2 显示更改
查看文件更改的详细信息:
git diff
5.3 还原更改
还原工作目录中的更改:
git checkout -- filename.txt
5.4 重置暂存区和工作目录
将暂存区和工作目录重置为最后一次提交状态:
git reset --hard
六、Git 工作流程示例
克隆仓库:
git clone git@github.com:YourUsername/YourRepository.git cd YourRepository
创建新分支:
git checkout -b new-feature
编辑文件: 编辑
file.txt
文件。添加和提交更改:
git add file.txt git commit -m "Edit file.txt"
推送分支到远程仓库:
git push origin new-feature
在 GitHub 上创建 Pull Request 并合并分支。
拉取最新更改:
git pull origin main
通过这些步骤,您可以轻松管理和维护您的代码库,同时利用 Git 和 GitHub 的强大功能进行协作开发。