macOS 系统
bash
# 方法1:Homebrew(推荐)
brew install git
# 方法2:官方安装包
下载地址:https://sourceforge.net/projects/git-osx-installer/
Linux 系统
bash
# Debian/Ubuntu
sudo apt update && sudo apt install git -y
# CentOS/RHEL
sudo yum install git -y
✅ 验证安装:
git --version
显示
git version 2.x.x
即成功
二、首次配置(全局设置)
bash
# 设置用户名(提交者身份)
git config --global user.name "你的名字"
# 设置邮箱(必须与GitHub/GitLab一致)
git config --global user.email "[email protected]"
# 启用颜色标记(提高可读性)
git config --global color.ui auto
# 查看配置
git config --list
三、核心工作流实战
场景1:创建本地仓库
bash
# 创建项目文件夹
mkdir my-project && cd my-project
# 初始化Git仓库
git init
# 创建文件并提交
echo "# Hello Git" > README.md
git add . # 添加所有文件到暂存区
git commit -m "Initial commit" # 提交到本地仓库
场景2:连接远程仓库(GitHub为例)
- 在GitHub创建新仓库 → 复制 HTTPS/SSH地址 (如
https://github.com/user/repo.git
) - 本地操作:
bash
# 关联远程仓库
git remote add origin https://github.com/user/repo.git
# 首次推送(-u 设置默认上游分支)
git push -u origin main
# 后续推送更新
git push
场景3:团队协作开发
bash
# 克隆远程仓库(下载代码)
git clone https://github.com/user/repo.git
# 创建新分支开发
git checkout -b feature-login
# 开发后提交
git add .
git commit -m "Add login function"
# 推送到远程分支
git push -u origin feature-login
# 合并到主分支(在GitHub发起Pull Request)
四、高频命令速查表
操作 | 命令 |
---|---|
查看当前状态 | git status |
查看提交历史 | git log --oneline |
撤销工作区修改 | git checkout -- <file> |
撤销暂存区文件 | git reset HEAD <file> |
回退到指定提交 | git reset --hard <commit-id> |
拉取远程更新 | git pull (相当于 git fetch + git merge ) |
解决冲突后继续合并 | git add . && git commit -m "Merge conflict resolved" |
储藏未完成工作 | git stash → 恢复 git stash pop |
五、图形化工具推荐(适合新手)
工具 | 特点 | 下载地址 |
---|---|---|
GitHub Desktop | 官方出品,简洁易用 | desktop.github.com |
Sourcetree | 支持Git Flow,功能强大 | www.sourcetreeapp.com |
VS Code Git集成 | 编辑器内置,无需切换 | code.visualstudio.com |
六、常见问题解决
1. git push
报错无权限
bash
# 检查远程地址类型
git remote -v
# 推荐使用SSH(需配置密钥)
ssh-keygen -t rsa -C "[email protected]" # 生成密钥
cat ~/.ssh/id_rsa.pub # 复制公钥到GitHub设置
git remote set-url origin [email protected]:user/repo.git
2. 提交了敏感文件(如密码)
bash
# 从历史记录中彻底删除文件
git filter-branch --force --index-filter \
"git rm --cached --ignore-unmatch config/password.txt" \
--prune-empty --tag-name-filter cat -- --all
# 强制推送到远程(警告:会重写历史)
git push origin --force --all
3. 分支合并冲突
- 打开冲突文件,定位
<<<<<<< HEAD
到>>>>>>> branch
区域 - 手动选择保留的代码 → 删除冲突标记
- 执行:
bash
git add .
git commit -m "Resolve merge conflict"
七、学习资源推荐
- 交互式练习 :Learn Git Branching(可视化分支操作)
- 官方电子书 :Pro Git(中文免费)
- 备忘清单 :Git Cheat Sheet
