Git 版本控制实战：分支、合并与回滚

# 把远程仓库克隆到本地，<url> 替换为实际地址
git clone https://github.com/用户名/项目名.git

# 进入项目目录
cd 项目名

# 查看当前有哪些分支（* 号表示当前所在分支）
git branch

# 输出类似：
#   feature/login
# * main              ← 星号在 main，说明你现在在主分支

# 新建一个叫 feature/user-auth 的分支，并自动切换过去
git checkout -b feature/user-auth

# 或者用新版写法（Git 1.20+，推荐）：
git switch -c feature/user-auth

# 现在你可以在这个分支上放心地改了——不会影响 main 分支

# 查看当前状态：哪些文件被修改了
git status

# 输出示例：
#   modified: src/auth.py
#   modified: tests/test_auth.py
#   new file:   docs/oauth-flow.md

# 把修改的文件添加到"暂存区"（也就是放入待提交清单）
git add src/auth.py tests/test_auth.py

# 或者一次性把所有改动全部加入暂存区（推荐日常使用）
git add .

# 正式提交到本地仓库（提交前请仔细写好 message！）
git commit -m "feat: 完成用户登录验证功能

- 新增 OAuth2.0 认证流程
- 添加登录页面单元测试
- 修复密码加密时的边界情况"

# 切回主分支
git checkout main

# 把 feature/user-auth 分支合并到 main
git merge feature/user-auth

# 如果有冲突，Git 会停下来让你手动解决（见第七节）

# 切换到你要"挪位置"的分支
git checkout feature/user-auth

# 把 feature/user-auth 的所有提交"搬"到 main 的最新提交之后
git rebase main

# 查看最近几次提交的 ID（取前几位就行）
git log --oneline -5

# 输出：
# a1b2c3d feat: 完成用户登录验证功能
# e4f5g6h fix: 修复密码加密 bug
# i7j8k9l docs: 更新 README

# 【软重置】只回退版本，但保留你的修改在工作区（方便继续改）
git reset --soft HEAD~1

# 【混合重置】回退版本 + 清除暂存区，但文件改动还在工作区
# ⭐ 最常用：相当于"撤销这次 commit"，改动留给你调整
git reset --mixed HEAD~1
# （--mixed 是默认值，可以简写为 git reset HEAD~1）

# 【硬重置】⚠️ 一切归零：回退版本 + 丢弃所有未提交的改动
# 警告：HEAD~1 之后的所有修改都会丢失！务必确认好再执行
git reset --hard HEAD~1

# 撤销某次特定提交，生成一个新的"反向提交"来抵消它的效果
git revert <commit-id>

# 举例：假设 a1b2c3d 那次提交出了问题
git revert a1b2c3d

# 【旧方法】放弃某个文件的所有未提交改动
git checkout -- src/auth.py

# 【新方法】Git 2.23+ 推荐的专用命令
git restore src/auth.py

# 如果想恢复之前某次提交中的某个文件版本
git restore --source=<commit-id> src/auth.py

# 把当前分支推送到远程同名分支
git push origin main

# 首次推送时需要告诉 Git 上游关系（之后就不用写了）
git push -u origin main
# -u = --set-upstream，记住"当前分支跟踪 origin/main"

# 推送指定分支
git push origin feature/user-auth

# 强制推送 ⚠️（只有确定要覆盖远程历史时才用）
git push --force-with-lease origin main
# --force-with-lease 比 --force 安全：如果别人在你的提交之后也 push 了，
# 它会拒绝推送而不是直接覆盖别人的代码

# 拉取远程最新代码并自动合并到当前分支
git pull origin main
# 等价于以下两步的组合：
# git fetch origin main   （下载远程最新内容，但不合并）
# git merge origin/main   （合并到当前分支）

# 如果你想先把本地改动暂存再拉取（避免冲突）
git stash                  # 把未提交的改动临时存放
git pull origin main       # 拉取远程更新
git stash pop              # 把暂存的改动放回来，可能需要解决冲突

# 1. 执行 merge 或 pull 时 Git 提示冲突
$ git merge feature/user-auth
Auto-merging config.py
CONFLICT (content): Merge conflict in config.py
Automatic merge failed; fix conflicts and then commit the result.

# 2. 看哪些文件有冲突
git status
# 输出会标注：both modified: config.py

# 3. 打开冲突文件，找到冲突标记
# config.py 的内容会是这样的：
# === 前面是你和同事都没改的部分 ===
database_port = 5432
<<<<<<< HEAD
database_host = "localhost"          ← 你（当前分支）的版本
=======
database_host = "192.168.1.100"      ← 对方（ incoming 分支）的版本
>>>>>>> feature/user-auth            ← 对方的提交标识
# === 后面又是没改的部分 ===

# 4. 手动编辑，决定保留哪个（或写一个折中方案）
# 比如改成：
database_host = "db.example.com"     # 用统一的数据库地址

# 5. 标记冲突已解决
git add config.py

# 6. 完成合并提交
git commit -m "Merge feature/user-auth: 解决 config.py 冲突"

# macOS
git mergetool --tool=opendiff

# Windows（安装了 VS Code 的话）
git mergetool --tool=code --no-index

# Linux（安装了 meld 的话）
git mergetool --tool=meld

# 完成后工具会问你：解决了？点了 Yes 就算你处理完了

# 以单行格式显示历史，附带作者和时间
git log --oneline --all --graph --decorate

# 输出类似：
# * f2a8b3c (HEAD -> main, origin/main) feat: 完成用户登录
# |\
# | * d4e5f6a (feature/login) feat: 新增登录页 UI
# |/
# * b1c2d3e fix: 修复密码加密 bug
# * a0b1c2d docs: 更新 README

# 加上日期，信息更全
git log --oneline --all --graph --date=short --format="%h %ad %s"

# 把当前的未提交改动"塞进口袋"
git stash save "WIP: 用户认证模块还差测试"

# 做点别的（比如修个紧急 bug）
git checkout main
# ... 修 bug ...
git commit -m "fix: 紧急修复登录超时问题"

# 做完回来，把之前塞进口的东西拿出来
git stash pop

# 想看口袋里还有多少个 stash
git stash list
# 输出：stash@{0}: WIP: 用户认证模块还差测试
#       stash@{1}: WIP: 首页改版

# 清理掉已经不需要的 stash
git stash drop stash@{0}
# 或者一键清空所有 stash
git stash clear

# 轻量标签（只是一个名字指向某个提交）
git tag v1.0.0

# 带注释的标签（更正式，推荐发布时用）
git tag -a v1.0.0 -m "Release v1.0.0 - 首个稳定版本"

# 把标签推送到远程（Git 默认不传标签）
git push origin v1.0.0
# 或者推送所有标签
git push origin --tags

# 检查某个标签指向哪里
git show v1.0.0

# 在项目根目录创建 .gitignore 文件
touch .gitignore

# 常见忽略规则（写入 .gitignore）：
# Python
__pycache__/
*.py[cod]
*.egg-info/
.venv/

# 系统文件
.DS_Store
Thumbs.db

# IDE
.vscode/
.idea/

# 敏感信息
.env
secrets.json

# 给常用命令设缩写（只需设置一次）
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.lg "log --oneline --all --graph --decorate"

# 之后只需要输入：
git st        # 代替 git status
git co main   # 代替 git checkout main
git lg        # 漂亮的日志视图

#!/usr/bin/env bash
# ============================================================
#  Git 版本控制实战 一键脚本（macOS / Linux / WSL）
#  公开源码，欢迎审查 —— 不放心可先复制给 AI 判断
#  功能：检测 git → 推荐配置 .gitconfig → 创建示例仓库
# ============================================================

GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; CYAN='\033[0;36m'; NC='\033[0m'
info()  { echo -e "${GREEN}[INFO]${NC} $1"; }
warn()  { echo -e "${YELLOW}[WARN]${NC} $1"; }
error() { echo -e "${RED}[ERROR]${NC} $1"; }
step()  { echo -e "${CYAN}[STEP]${NC} $1"; }

detect_network() {
  step "检测网络环境（国内 / 国外）..."
  if curl -fsI --max-time 5 "https://claude.ai" >/dev/null 2>&1; then
    info "可直连 claude.ai，判定为海外网络"
    echo "overseas"
  else
    warn "无法直连 claude.ai，判定为国内网络环境（将推荐镜像源 + 加速配置）"
    echo "domestic"
  fi
}

check_git() {
  step "检查 Git 是否安装..."
  if command -v git >/dev/null 2>&1; then
    local VERSION
    VERSION=$(git --version 2>/dev/null)
    info "Git 已安装：$VERSION"
    return 0
  fi
  warn "Git 未安装，开始安装..."

  local NET="$1"

  # 根据操作系统选择安装方式
  if command -v apt >/dev/null 2>&1; then
    # Debian / Ubuntu
    if [ "$NET" = "domestic" ]; then
      info "国内环境，使用清华镜像源安装..."
      if sudo apt update -o Dir::Etc::sourcelist="sources.list.d/debian-mirror.sources" \
         -o Dir::Etc::sourceparts="-" -o APT::Get::List-Cleanup="0" 2>/dev/null; then
        sudo apt install -y git
      else
        # CONNECT 断网回退：尝试阿里源
        warn "清华源失败，回退阿里源..."
        sudo apt install -y git 2>/dev/null || true
      fi
    else
      sudo apt install -y git
    fi
  elif command -v yum >/dev/null 2>&1; then
    # CentOS / RHEL / Fedora
    sudo yum install -y git
  elif command -v brew >/dev/null 2>&1; then
    # macOS Homebrew
    if [ "$NET" = "domestic" ]; then
      info "国内环境，Homebrew 使用清华大学镜像..."
      export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
    fi
    brew install git
  elif command -v apk >/dev/null 2>&1; then
    # Alpine Linux
    sudo apk add git
  else
    error "无法识别的包管理器。请手动安装 Git："
    echo "  官网：https://git-scm.com/downloads"
    echo "  国内镜像：https://mirrors.aliyun.com/gitosis/git-for-windows/"
    return 1
  fi

  if command -v git >/dev/null 2>&1; then
    info "Git 安装成功！"
    return 0
  else
    error "Git 安装失败。请确保你有管理员权限（sudo）。"
    echo "  也可以手动下载安装：https://git-scm.com/downloads"
    return 1
  fi
}

configure_gitconfig() {
  step "配置 ~/.gitconfig（提升日常体验）..."

  cat > ~/.gitconfig <<'GITCONFIG'
[user]
	name = YourName
	email = [email protected]
[init]
	defaultBranch = main
[core]
	autocrlf = false
	eol = lf
[color]
	ui = auto
[alias]
	st = status
	br = branch
	co = checkout
	cm = commit
	lg = log --oneline --all --graph --decorate
	lga = log --oneline --all --graph --decorate --date=short
[push]
	default = simple
 GITCONFIG

  info "~/.gitconfig 已生成（请编辑第 3-4 行，填入你的名字和邮箱）"
  info "已设置别名：st=status, br=branch, co=checkout, cm=commit, lg=漂亮日志"

  if [ "$(uname)" = "Darwin" ]; then
    warn "macOS 注意：Git 默认会做 CRLF/LF 转换。上面的 autocrlf=false 已关闭。"
    warn "如需用 Windows 风格换行，改为 autocrlf=true"
  fi
}

create_demo_repo() {
  step "创建示例仓库演示 git init / add / commit..."

  local DEMO_DIR="$HOME/git-demo-project"

  if [ -d "$DEMO_DIR" ]; then
    warn "示例仓库已存在：$DEMO_DIR"
    echo "  想重新创建请先删除：rm -rf $DEMO_DIR"
    return 0
  fi

  mkdir -p "$DEMO_DIR" && cd "$DEMO_DIR" || exit 1

  git init
  git checkout -b main

  # 创建几个示例文件
  cat > README.md <<'README'
# Git Demo Project

这是一个用于练习 Git 的示例仓库。
跟着下面的步骤走一遍，你就能熟悉最常用的 Git 命令。

## 练习步骤

1. 创建新分支:  \`git switch -c feature/hello\`
2. 修改文件并提交
3. 回到 main 并合并:  \`git merge feature/hello\`
4. 试试回滚:  \`git reset\` 或 \`git revert\`
README

  cat > app.py <<'PYEOF'
"""简易示例：欢迎程序"""

def greet(name: str) -> str:
    return f"Hello, {name}! Welcome to Git practice."

if __name__ == "__main__":
    print(greet("World"))
PYEOF

  mkdir -p tests
  cat > tests/test_app.py <<'TESTEOF'
"""示例测试"""
from app import greet

def test_greet():
    assert greet("Git") == "Hello, Git! Welcome to Git practice."

def test_greet_empty():
    assert greet("") == "Hello, ! Welcome to Git practice."

if __name__ == "__main__":
    test_greet()
    test_greet_empty()
    print("All tests passed!")
TESTEOF

  # 忽略虚拟环境目录
  echo ".venv/" > .gitignore

  git add .
  git commit -m "init: 创建示例项目结构"

  info "示例仓库已创建：$DEMO_DIR"
  echo ""
  info "接下来请在 $DEMO_DIR 中练习以下步骤："
  echo "  1. 创建分支:  git switch -c feature/hello"
  echo "  2. 编辑文件，然后:"
  echo "     git add ."
  echo "     git commit -m 'feat: 练习提交'"
  echo "  3. 合并回 main:"
  echo "     git switch main"
  echo "     git merge feature/hello"
  echo "  4. 回滚实验:"
  echo "     git reset --soft HEAD~1    # 试试不同的 reset 模式"
}

main() {
  echo "============================================"
  echo "  Git 版本控制实战 一键配置脚本"
  echo "  适用于 macOS / Linux / WSL"
  echo "============================================"
  echo ""
  echo "  公开源码，欢迎审查 —— 可复制给 AI 判断"
  echo "  功能：检测 git / 推荐配置 / 创建练习仓库"
  echo ""

  local NET
  NET=$(detect_network)

  check_git "$NET" || {
    error "Git 不可用，脚本终止。"
    exit 1
  }

  configure_gitconfig
  create_demo_repo

  echo ""
  echo "============================================"
  info "全部完成！"
  echo "  Git 配置已就绪，示例仓库在 ~/git-demo-project/"
  echo "  进去跟着练一遍基础命令就能上手了"
  echo "  配置别名：git st | git br | git co | git lg"
  echo ""
  echo "  想让 AI 帮你写 commit message 或查报错？"
  echo "  用云端 OpenAI 兼容 API（如 https://cloudzone-api.cyou/，"
  echo "  国内直连免翻墙，90+ 模型，0.05x 起）"
  echo "============================================"
}

main "$@"

# ============================================================
#  Git 版本控制实战 一键脚本（Windows PowerShell）
#  公开源码，欢迎审查 -- 不放心可先复制给 AI 判断
#  功能：检测 git → 推荐配置 .gitconfig → 创建示例仓库
# ============================================================
$ErrorActionPreference = "Stop"

function Write-Info  { Write-Host "[INFO] $args" -ForegroundColor Green }
function Write-Warn  { Write-Host "[WARN] $args" -ForegroundColor Yellow }
function Write-Err   { Write-Host "[ERROR] $args" -ForegroundColor Red }
function Write-Step  { Write-Host "[STEP] $args" -ForegroundColor Cyan }

function Detect-Network {
    Write-Step "检测网络环境（国内 / 国外）..."
    try {
        $null = Invoke-WebRequest -Uri "https://claude.ai" -Method Head -TimeoutSec 5 -UseBasicParsing
        Write-Info "可直连 claude.ai，判定为海外网络"
        return "overseas"
    } catch {
        Write-Warn "无法直连 claude.ai，判定为国内网络环境（将推荐镜像源 + 加速配置）"
        return "domestic"
    }
}

function Check-Git {
    Write-Step "检查 Git 是否安装..."
    $gitCmd = Get-Command git -ErrorAction SilentlyContinue
    if ($gitCmd) {
        $versionOutput = & git --version 2>&1
        Write-Info "Git 已安装：$versionOutput"
        return $true
    }

    Write-Warn "Git 未安装，请先安装："
    Write-Host ""
    Write-Host "  方式一（推荐，Chocolatey）："
    Write-Host "    以管理员身份打开 PowerShell，运行："
    Write-Host '    choco install git -y'
    Write-Host ""
    Write-Host "  方式二（winget）："
    Write-Host "    winget install Git.Git"
    Write-Host ""
    Write-Host "  方式三（手动下载）："
    Write-Host "    官网：https://git-scm.com/download/win"
    Write-Host "    国内镜像：https://mirrors.aliyun.com/gitosis/git-for-windows/"
    Write-Host ""
    Write-Host "  安装完成后请重启 PowerShell 再运行本脚本。"
    return $false
}

function Configure-GitConfig {
    Write-Step "生成 ~/.gitconfig 推荐配置..."

    $gitConfigContent = @"
[user]
	name = YourName
	email = [email protected]
[init]
	defaultBranch = main
[core]
	autocrlf = input
	eol = crlf
[color]
	ui = auto
[alias]
	st = status
	br = branch
	co = checkout
	cm = commit
	lg = log --oneline --all --graph --decorate
[push]
	default = simple
"@

    $gitConfigPath = Join-Path $env:USERPROFILE ".gitconfig"

    if (Test-Path $gitConfigPath) {
        Write-Warn "~/.gitconfig 已存在，将备份后写入推荐配置"
        Copy-Item $gitConfigPath "$gitConfigPath.bak.$((Get-Date).ToString('yyyyMMdd-HHmmss'))" -Force
    }

    $gitConfigContent | Out-File -FilePath $gitConfigPath -Encoding UTF8
    Write-Info "~/.gitconfig 已生成（请编辑第 3-4 行，填入你的名字和邮箱）"
    Write-Info "已设置别名：st=status, br=branch, co=checkout, cm=commit, lg=漂亮日志"
    Write-Host ""
    Write-Host "  Windows 注意：autocrlf=input 会在提交时把 CRLF 转为 LF，"
    Write-Host "  检出时保留 CRLF（适合 Windows 编辑器）。"
    Write-Host "  如需始终用 LF，把上面模板中的 autocrlf 改为 false"
}

function Create-DemoRepo {
    Write-Step "创建示例仓库演示 git init / add / commit..."

    $demoDir = Join-Path $env:USERPROFILE "git-demo-project"

    if (Test-Path $demoDir) {
        Write-Warn "示例仓库已存在：$demoDir"
        Write-Host "  想重新创建请先删除：Remove-Item -Recurse -Force $demoDir"
        return
    }

    New-Item -ItemType Directory -Path $demoDir -Force | Out-Null
    Set-Location $demoDir

    git init
    git checkout -b main 2>$null -or git branch -m main

    # README.md
    @"
# Git Demo Project

这是一个用于练习 Git 的示例仓库。
跟着下面的步骤走一遍，你就能熟悉最常用的 Git 命令。

## 练习步骤

1. 创建新分支:  \`git switch -c feature/hello\`
2. 修改文件并提交
3. 回到 main 并合并:  \`git merge feature/hello\`
4. 试试回滚:  \`git reset\` 或 \`git revert\`
"@ | Out-File -FilePath "README.md" -Encoding UTF8

    # app.py
    @"
'''简易示例：欢迎程序'''

def greet(name: str) -> str:
    return f"Hello, {name}! Welcome to Git practice."

if __name__ == "__main__":
    print(greet("World"))
"@ | Out-File -FilePath "app.py" -Encoding UTF8

    # tests/test_app.py
    New-Item -ItemType Directory -Path "tests" -Force | Out-Null
    @"
'''示例测试'''
from app import greet

def test_greet():
    assert greet("Git") == "Hello, Git! Welcome to Git practice."

def test_greet_empty():
    assert greet("") == "Hello, ! Welcome to Git practice."

if __name__ == "__main__":
    test_greet()
    test_greet_empty()
    print("All tests passed!")
"@ | Out-File -FilePath "tests/test_app.py" -Encoding UTF8

    # .gitignore
    ".venv/" | Out-File -FilePath ".gitignore" -Encoding UTF8

    git add .
    git commit -m "init: 创建示例项目结构"

    Write-Info "示例仓库已创建：$demoDir"
    Write-Host ""
    Write-Info "接下来请在 $demoDir 中练习："
    Write-Host "  1. 创建分支:  git switch -c feature/hello"
    Write-Host "  2. 编辑文件，然后:"
    Write-Host "     git add ."
    Write-Host "     git commit -m 'feat: 练习提交'"
    Write-Host "  3. 合并回 main:"
    Write-Host "     git switch main"
    Write-Host "     git merge feature/hello"
    Write-Host "  4. 回滚实验:"
    Write-Host "     git reset --soft HEAD~1    # 试试不同的 reset 模式"
}

# ---- 主入口 ----

Write-Host "============================================"
Write-Host "  Git 版本控制实战 一键配置脚本"
Write-Host "  适用于 Windows (PowerShell)"
Write-Host "============================================"
Write-Host ""
Write-Host "  公开源码，欢迎审查 -- 可复制给 AI 判断"
Write-Host "  功能：检测 git / 推荐配置 / 创建练习仓库"
Write-Host ""

$net = Detect-Network

if (-not (Check-Git)) {
    Write-Err "Git 未安装，请安装后重跑本脚本。"
    Write-Host ""
    Write-Host "  快速安装（需要管理员权限）："
    Write-Host "    choco install git -y      (Chocolatey)"
    Write-Host "    winget install Git.Git    (winget)"
    exit 1
}

Configure-GitConfig
Create-DemoRepo

Write-Host ""
Write-Host "============================================"
Write-Info "全部完成！"
Write-Host "  Git 配置已就绪，示例仓库在 ~/git-demo-project/"
Write-Host "  进去跟着练一遍基础命令就能上手了"
Write-Host "  配置别名：git st | git br | git co | git lg"
Write-Host ""
Write-Host "  想让 AI 帮你写 commit message 或查报错？"
Write-Host "  用云端 OpenAI 兼容 API（如 https://cloudzone-api.cyou/，"
Write-Host "  国内直连免翻墙，90+ 模型，0.05x 起）"
Write-Host "============================================"