# 创建项目目录并初始化
$ mkdir my-project
$ cd my-project
$ git init
Initialized empty Git repository in /home/user/my-project/.git/

# 查看生成的 .git 目录
$ ls -la .git/
total 40
drwxr-xr-x 7 user user 4096 May 10 10:00 .
drwxr-xr-x 3 user user 4096 May 10 10:00 ..
-rw-r--r-- 1 user user   23 May 10 10:00 HEAD
drwxr-xr-x 2 user user 4096 May 10 10:00 branches
-rw-r--r-- 1 user user   92 May 10 10:00 config
-rw-r--r-- 1 user user   73 May 10 10:00 description
drwxr-xr-x 2 user user 4096 May 10 10:00 hooks
drwxr-xr-x 2 user user 4096 May 10 10:00 info
drwxr-xr-x 4 user user 4096 May 10 10:00 objects
drwxr-xr-x 4 user user 4096 May 10 10:00 refs

# 默认分支名建议设为 main
$ git init -b main
Initialized empty Git repository in /home/user/my-project/.git/

# 或通过全局配置
$ git config --global init.defaultBranch main

# HTTPS 方式克隆
$ git clone https://github.com/user/repo.git

# SSH 方式克隆（推荐）
$ git clone [email protected]:user/repo.git

# 指定目录名
$ git clone [email protected]:user/repo.git my-local-name

# 浅克隆（只获取最近 N 次提交，节省时间）
$ git clone --depth 1 [email protected]:user/repo.git

# 克隆指定分支
$ git clone -b develop [email protected]:user/repo.git

# 克隆包含子模块
$ git clone --recursive [email protected]:user/repo.git

# 暂存单个文件
$ git add README.md

# 暂存多个文件
$ git add file1.txt file2.txt file3.txt

# 暂存当前目录所有变更
$ git add .

# 暂存所有变更（包括删除）
$ git add -A
# 等价于
$ git add --all

# 交互式暂存（选择性暂存部分内容）
$ git add -p
# 或
$ git add --patch

$ git add -p
diff --git a/src/main.py b/src/main.py
index abc1234..def5678 100644
--- a/src/main.py
+++ b/src/main.py
@@ -10,6 +10,8 @@ def main():
     print("Hello")
+    print("World")
+    print("Git")
(1/1) Stage this hunk [y,n,q,a,d,s,e,?]?

# 提交并附带提交信息
$ git commit -m "Add user authentication module"

# 提交所有已跟踪文件的变更（跳过 add）
$ git commit -a -m "Fix typo in README"
# 等价于
$ git commit -am "Fix typo in README"

# 使用编辑器编写多行提交信息
$ git commit
# 会打开默认编辑器

# 修改最近一次提交
$ git commit --amend -m "New commit message"

# 修改最近一次提交（保留原信息）
$ git commit --amend --no-edit

# 创建空提交（用于触发 CI/CD）
$ git commit --allow-empty -m "Trigger build"

# 简单提交
$ git commit -m "feat: add user login page"

# 带详细说明的提交
$ git commit -m "fix(auth): resolve token expiration issue

- Refresh token before API call
- Add retry logic for 401 responses
- Update token storage to use secure cookies

Closes #123"

# 完整状态
$ git status
On branch main
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        new file:   src/app.py
        modified:   README.md

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
        modified:   src/utils.py

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        tests/test_app.py

# 简洁模式（推荐日常使用）
$ git status -sb
## main...origin/main [ahead 1]
 M src/utils.py
M  README.md
A  src/app.py
?? tests/test_app.py

# 完整日志
$ git log

# 单行简洁格式
$ git log --oneline
abc1234 Initial commit
def5678 Add README
ghi9012 Fix typo

# 带图形的分支图
$ git log --oneline --graph --decorate --all
* abc1234 (HEAD -> main, origin/main) Latest commit
| * def5678 (feature) Feature commit
|/
* ghi9012 Initial commit

# 限制显示数量
$ git log -n 5               # 最近 5 条

# 按作者过滤
$ git log --author="John"
$ git log --author="[email protected]"

# 按日期过滤
$ git log --since="2024-01-01"
$ git log --until="2024-06-30"
$ git log --since="2 weeks ago"

# 按提交信息搜索
$ git log --grep="fix"
$ git log --grep="feat" --grep="fix" --all-match

# 按文件过滤
$ git log -- src/main.py
$ git log --follow -- src/main.py    # 包含重命名历史

# 按分支差异
$ git log main..feature              # feature 有但 main 没有的提交
$ git log main...feature             # 两个分支独有的提交

# 显示每次提交的变更统计
$ git log --stat

# 显示每次提交的具体修改
$ git log -p
$ git log --patch

# 按内容搜索（引入/删除了特定代码的提交）
$ git log -S "function_name"
$ git log -G "regex_pattern"

# 自定义格式
$ git log --pretty=format:"%h %an %ar %s"
abc1234 John 2 hours ago Fix bug

# 常用格式占位符
# %H  完整提交哈希
# %h  简短提交哈希
# %an 作者名
# %ae 作者邮箱
# %ar 相对时间
# %s  提交信息标题
# %d  引用（分支、标签）
# %n  换行

# 设置别名
$ git config --global alias.lg "log --oneline --graph --decorate --all --date=short --format='%C(yellow)%h%C(reset) %C(green)%ad%C(reset) %C(blue)%an%C(reset) %C(red)%d%C(reset) %s'"

# 创建 .gitignore
$ touch .gitignore

# 设置全局忽略文件
$ git config --global core.excludesfile ~/.gitignore_global

# 编辑全局忽略文件
$ vim ~/.gitignore_global

# 方法 1：使用 .gitkeep（约定俗成）
$ mkdir -p logs/uploads
$ touch logs/uploads/.gitkeep
$ git add logs/uploads/.gitkeep

# 方法 2：使用 .gitignore（保留目录但忽略内容）
$ echo "*" > logs/.gitignore
$ echo "!.gitignore" >> logs/.gitignore

# 1. 创建项目
$ mkdir web-app && cd web-app
$ git init -b main

# 2. 创建 .gitignore
$ cat > .gitignore << 'EOF'
node_modules/
.env
.DS_Store
*.log
dist/
EOF

# 3. 创建初始文件
$ echo "# Web App" > README.md
$ mkdir src
$ cat > src/index.js << 'EOF'
const express = require('express');
const app = express();

app.get('/', (req, res) => {
    res.send('Hello Git!');
});

app.listen(3000, () => {
    console.log('Server running on port 3000');
});
EOF

# 4. 查看状态
$ git status -sb
?? .gitignore
?? README.md
?? src/

# 5. 暂存所有文件
$ git add -A

# 6. 确认暂存内容
$ git status
Changes to be committed:
  new file:   .gitignore
  new file:   README.md
  new file:   src/index.js

# 7. 首次提交
$ git commit -m "feat: initial project setup"

# 8. 修改文件
$ echo "node_modules/" >> .gitignore
$ echo "console.log('App started');" >> src/index.js

# 9. 查看差异
$ git diff
diff --git a/src/index.js b/src/index.js
index abc1234..def5678 100644
--- a/src/index.js
+++ b/src/index.js
@@ -9,3 +9,4 @@ app.listen(3000, () => {
     console.log('Server running on port 3000');
 });
+console.log('App started');

# 10. 暂存并提交
$ git add -A
$ git commit -m "feat: add startup log message"

# 11. 查看提交历史
$ git log --oneline
def5678 feat: add startup log message
abc1234 feat: initial project setup