Week 02: 工作区、暂存区与配置系统

+------------------+
| Header           |
|  - signature     | 4 bytes: "DIRC"
|  - version       | 4 bytes: 2, 3, or 4
|  - entry count   | 4 bytes
+------------------+
| Entry 1          |
|  - ctime         | 8 bytes
|  - mtime         | 8 bytes
|  - dev, ino      | 8 bytes
|  - mode          | 4 bytes
|  - uid, gid      | 8 bytes
|  - file size     | 4 bytes
|  - SHA-1         | 20 bytes
|  - flags         | 2 bytes
|  - path          | variable
+------------------+
| Entry 2          |
| ...              |
+------------------+
| Extensions       |
+------------------+
| Checksum         | 20 bytes SHA-1
+------------------+

# 列出 Index 中的文件
git ls-files

# 详细信息 (含 SHA-1 和权限)
git ls-files --stage

# 调试输出
git ls-files --debug

# 查看冲突文件的三个阶段
git ls-files -u
# 100644 abc123 1 conflict.txt  (base)
# 100644 def456 2 conflict.txt  (ours)
# 100644 ghi789 3 conflict.txt  (theirs)

# 简洁状态
git status -s

# 状态码含义
#  M  修改但未暂存
# M   已暂存
# MM  暂存后又修改
# A   新增文件
# D   删除文件
# R   重命名
# ??  未跟踪

# 交互式暂存
git add -i

# 按 hunk 暂存
git add -p
# y = 暂存此块
# n = 不暂存
# s = 拆分成更小的块
# e = 手动编辑

# 暂存部分文件
git add -p file.txt

# 注释
*.log           # 忽略所有 .log 文件
/build          # 忽略根目录的 build 目录
build/          # 忽略所有 build 目录
!important.log  # 例外: 不忽略此文件
**/temp         # 匹配任意层级的 temp 目录
*.py[cod]       # 字符类: .pyc, .pyo, .pyd

# 停止跟踪但保留本地文件
git rm --cached file.txt

# 临时忽略 (不修改 .gitignore)
git update-index --assume-unchanged file.txt

# 恢复跟踪
git update-index --no-assume-unchanged file.txt

# 文本处理
*.txt text
*.sh  text eol=lf
*.bat text eol=crlf

# 二进制文件
*.png binary
*.jpg binary

# 合并策略
*.lock merge=ours

# 差异显示
*.md  diff=markdown
*.png diff=exif

# LFS (大文件存储)
*.psd filter=lfs diff=lfs merge=lfs -text

# 查看配置来源
git config --list --show-origin

# 查看生效的配置
git config --list

# 编辑配置
git config --global --edit

# 用户信息
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

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

# 编辑器
git config --global core.editor "vim"

# 差异工具
git config --global diff.tool vimdiff

# 合并工具
git config --global merge.tool vimdiff

# 换行符处理
git config --global core.autocrlf input  # Linux/Mac
git config --global core.autocrlf true   # Windows

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.unstage 'reset HEAD --'
git config --global alias.last 'log -1 HEAD'
git config --global alias.visual '!gitk'

# 图形化日志
git config --global alias.lg "log --graph --oneline --decorate --all"

# 查看文件历史
git config --global alias.filelog "log -u"

# ~/.gitconfig
[user]
    name = Personal Name
    email = personal@email.com

[includeIf "gitdir:~/work/"]
    path = ~/.gitconfig-work

# ~/.gitconfig-work
[user]
    name = Work Name
    email = work@company.com

#!/bin/sh
# .git/hooks/pre-commit

# 运行 linter
if ! npm run lint; then
    echo "Lint failed. Commit aborted."
    exit 1
fi

# 检查敏感信息
if git diff --cached | grep -E "(password|secret|api_key)\s*="; then
    echo "Potential secrets detected. Commit aborted."
    exit 1
fi

#!/bin/sh
# .git/hooks/commit-msg

# Conventional Commits 格式检查
if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .+" "$1"; then
    echo "Commit message must follow Conventional Commits format."
    echo "Example: feat(auth): add login endpoint"
    exit 1
fi

# 方法 1: 配置 hooks 路径
git config core.hooksPath .githooks

# 方法 2: 使用工具 (husky, pre-commit)
npx husky install
npx husky add .husky/pre-commit "npm run lint"

# 示例: 在任意目录操作仓库
export GIT_DIR=/path/to/repo/.git
export GIT_WORK_TREE=/path/to/repo
git status

# 创建一个过去日期的提交
GIT_AUTHOR_DATE="2000-01-01 12:00:00" git commit -m "Ancient commit"

# 调试网络连接
GIT_CURL_VERBOSE=1 git clone https://github.com/user/repo.git

git reset [--soft | --mixed | --hard] <commit>

# 恢复工作区文件
git restore file.txt

# 取消暂存
git restore --staged file.txt

# 从特定提交恢复
git restore --source=HEAD~2 file.txt