Skip to Content
开发📦 基础设施版本控制Git 完全指南

安装与配置

安装 Git

Git 是目前最先进的分布式版本控制系统。

各平台安装方法

  • Windows：下载并安装 git（默认路径安装）
  • macOS：
  • Linux：
    • Debian/Ubuntu：sudo apt-get install git-core
    • Red Hat/CentOS：sudo yum install git-core

安装验证命令：

git --version

环境配置

1. GitHub 账户注册

  1. 访问 GitHub 官网
  2. 使用邮箱完成验证注册
  3. 注意：中国大陆地区建议使用网络加速工具

2. SSH 密钥配置

git config --global user.name "你的GitHub用户名"
git config --global user.email "注册邮箱"
ssh-keygen -t rsa -C "注册邮箱"  # 连续回车三次

密钥文件位置：

  • Windows：C:\Users\用户名\.ssh\id_rsa.pub
  • macOS/Linux：~/.ssh/id_rsa.pub

3. GitHub 密钥绑定

  1. 登录GitHub → Settings → SSH and GPG keys
  2. 点击 New SSH key
  3. 粘贴公钥文件内容

基础操作

仓库管理

创建新仓库

  1. 仓库命名规范：username.github.io（替换为你的用户名）
  2. 建议勾选 Initialize with README
  3. 通过 https://username.github.io 访问页面

本地仓库初始化

git init
git add .
git commit -m "初始提交"
git branch -M main

代码操作

远程仓库关联

git remote add origin git@github.com:用户名/仓库名.git

代码推送

git push -u origin main

强制推送

git push -f origin main  # 慎用！会覆盖远程历史

版本回退操作

查看提交历史

git log

回退到指定版本

git reset --hard 版本号

回退到上一个版本

git reset --hard HEAD^

团队协作注意事项：

  1. 回退前确保当前分支未被他人协作
  2. 回退后必须强制推送前通知团队成员
  3. 建议使用 git revert 代替重置操作

分支管理

创建分支

git branch 分支名

切换分支

git checkout 分支名

合并分支

git merge 分支名

删除分支

git branch -d 分支名

远程仓库操作

克隆远程仓库

git clone 仓库地址

同步远程仓库

git pull

推送本地分支到远程

git push origin 分支名

代码冲突解决

  1. 手动解决冲突
  2. 提交合并
  3. 推送

最佳实践

分支策略

  • 主分支：main
  • 功能分支：feature/功能名
  • 修复分支：bugfix/问题描述

提交规范

  • 清晰的提交消息
  • 代码注释
  • 文档更新

进阶主题

开发环境集成

Git 命令行

  1. 打开终端
  2. 进入项目目录
  3. 使用Git命令

版本回退操作

1. 重置操作 (reset)

# 回退到上个版本（保留修改）
git reset HEAD^
 
# 强制回退到指定提交（丢失未提交修改）
git reset --hard <commit-id>

⚠️ 警告：hard 模式会丢失所有未提交的修改

2. 撤销操作 (revert)

# 创建新的撤销提交
git revert <commit-id>

🔑 优势：可保留完整提交历史，适合团队协作

3. 历史查看 (reflog)

# 显示所有操作记录（含已删除的提交）
git reflog
 
# 恢复误删分支
git checkout -b <new-branch> <commit-id>

恢复误操作流程

  1. 通过 git reflog 查找丢失的提交 ID
  2. 使用 git reset --hard <commit-id> 恢复
  3. 强制推送更新：git push -f origin main

⚠️ 强制推送注意事项：

  • 仅限个人仓库使用
  • 会覆盖远程历史记录
  • 团队协作时需提前通知成员

VS Code 集成

  1. 源代码管理面板查看变更
  2. 通过远程菜单添加仓库
  3. 使用图形化界面完成提交推送

核心命令速查

命令功能
git init初始化仓库
git clone克隆远程仓库
git status查看变更状态
git add添加文件跟踪
git commit提交变更
git push推送至远程
git pull拉取远程更新
git log查看提交历史
git checkout切换分支/版本
git reset版本回退
git revert安全撤销提交
git reflog查看操作历史

常见问题

❖ 环境变量配置失败

  • Windows：将Git安装目录下的cmd文件夹路径添加到系统环境变量
  • 检查命令：where git

❖ SSH连接超时

ssh -T git@github.com  # 测试连接
Last updated on
版本控制系统单元测试