Git基础¶

# 方式一：下载安装包
# 访问 https://git-scm.com/download/win 下载安装

# 方式二：使用 winget
winget install Git.Git

# 方式三：使用 scoop
scoop install git

# 方式一：Xcode Command Line Tools（推荐）
xcode-select --install

# 方式二：Homebrew
brew install git

sudo apt update
sudo apt install git

git --version
# git version 2.43.0

# 设置用户名和邮箱（每次提交都会记录）
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 查看配置
git config --list
git config user.name

# 设置默认分支名为 main
git config --global init.defaultBranch main

# 设置默认编辑器
git config --global core.editor "code --wait"    # VS Code
git config --global core.editor "vim"             # Vim

# 处理换行符（跨平台协作必备）
git config --global core.autocrlf true    # Windows
git config --global core.autocrlf input   # macOS/Linux

# 启用颜色显示
git config --global color.ui auto

# 设置中文文件名正确显示
git config --global core.quotepath false

# 1. 生成 SSH Key
ssh-keygen -t ed25519 -C "your.email@example.com"
# 一路回车使用默认设置（或设置密码短语更安全）

# 2. 查看公钥
cat ~/.ssh/id_ed25519.pub

# 3. 将公钥添加到 GitHub
# Settings → SSH and GPG keys → New SSH key → 粘贴公钥

# 4. 测试连接
ssh -T git@github.com
# Hi username! You've successfully authenticated...

# 5. 启动 ssh-agent 并添加密钥
eval "$(ssh-agent -s)"  # $()命令替换：执行命令并获取输出
ssh-add ~/.ssh/id_ed25519

# 初始化一个新仓库
mkdir my-project
cd my-project
git init
# 输出：Initialized empty Git repository in .../my-project/.git/

# 克隆远程仓库
git clone https://github.com/user/repo.git
git clone git@github.com:user/repo.git           # SSH方式（推荐）
git clone https://github.com/user/repo.git my-dir # 指定目录名
git clone --depth 1 https://github.com/user/repo.git  # 浅克隆（只获取最新提交）

# 查看当前状态（一定要养成习惯！）
git status
git status -s    # 简洁模式

# 添加文件到暂存区
git add file.txt           # 添加指定文件
git add dir/               # 添加整个目录
git add .                  # 添加当前目录所有变更
git add -A                 # 添加所有变更（包括删除）
git add -p                 # 交互式添加（选择部分修改，高级用法）

# 查看差异
git diff                   # 工作区 vs 暂存区
git diff --staged          # 暂存区 vs 最新提交（同 --cached）
git diff HEAD              # 工作区 vs 最新提交
git diff branch1 branch2   # 比较两个分支
git diff commit1 commit2   # 比较两个提交

# 基本提交
git commit -m "提交信息"

# 打开编辑器写详细提交信息
git commit

# 跳过暂存区直接提交（仅限已跟踪的文件）
git commit -a -m "修改已跟踪文件"

# 修改最后一次提交（⚠️ 会改变历史）
git commit --amend -m "更正的提交信息"
git commit --amend --no-edit  # 仅补充文件，不改提交信息

# 空提交（用于触发 CI）
git commit --allow-empty -m "trigger CI"

# 基本查看
git log

# 常用参数组合
git log --oneline                    # 单行显示
git log --oneline --graph --all      # 图形化显示所有分支（最常用✨）
git log --oneline -10                # 显示最近10条
git log --author="name"              # 按作者过滤
git log --since="2024-01-01"         # 按日期过滤
git log --grep="fix"                 # 按提交信息过滤
git log -- path/to/file              # 查看某文件的修改历史
git log -p                           # 显示每次提交的diff
git log --stat                       # 显示文件修改统计

# 美化输出
git log --pretty=format:"%h %an %ar : %s"
# 输出：a1b2c3d John 2 hours ago : feat: add login page

# 推荐别名
git log --oneline --graph --all --decorate

# --soft：只移动 HEAD 指针，暂存区和工作区不变
# 场景：想修改最近几次提交的内容
git reset --soft HEAD~1

# --mixed（默认）：移动 HEAD 并重置暂存区，工作区不变
# 场景：取消 git add，但保留文件修改
git reset HEAD~1
git reset HEAD file.txt   # 取消单个文件的暂存

# --hard：三者全部重置 ⚠️ 工作区修改会丢失！
# 场景：彻底放弃最近的修改
git reset --hard HEAD~1
git reset --hard origin/main  # 强制与远程同步

# 撤销指定提交
git revert <commit-hash>

# 撤销最近一次提交
git revert HEAD

# 撤销多个连续提交
git revert HEAD~3..HEAD

# 撤销但不自动提交（先查看效果）
git revert --no-commit <commit-hash>

# 暂存当前工作进度
git stash
git stash push -m "正在开发用户模块"  # 添加描述信息（注意：旧版 git stash save 已弃用）
git stash -u                         # 包含未跟踪文件
git stash -a                         # 包含被忽略的文件

# 查看暂存列表
git stash list
# stash@{0}: On feature: 正在开发用户模块
# stash@{1}: WIP on main: a1b2c3d fix: typo

# 恢复暂存
git stash pop              # 恢复最近的暂存，并删除该记录
git stash apply            # 恢复最近的暂存，保留记录
git stash apply stash@{1}  # 恢复指定暂存

# 删除暂存
git stash drop stash@{0}   # 删除指定暂存
git stash clear             # 清空所有暂存

# 从暂存创建新分支（避免恢复时冲突）
git stash branch new-branch stash@{0}

# 创建全局忽略文件
git config --global core.excludesfile ~/.gitignore_global

# .gitignore 只对未跟踪的文件生效
# 如果文件已被跟踪，需要先删除缓存
git rm --cached file.txt          # 从跟踪中移除但保留本地文件
git rm --cached -r directory/     # 移除整个目录的跟踪

# 然后将该文件/目录添加到 .gitignore
echo "file.txt" >> .gitignore
git commit -m "chore: 更新gitignore"