@gordon.gan/specflow 1.4.0-beta → 1.4.1

package/skills/database/mysql/examples/02-slow-query-optimization.md

@@ -0,0 +1,98 @@
+# 示例: 慢查询优化实战
+
+## 场景
+
+电商系统中查询"最近一个月下单超过 5 次的 VIP 用户及其总消费金额"的报表越来越慢。
+
+## 原始查询
+
+```sql
+SELECT 
+  u.id, u.name, u.email,
+  COUNT(o.id) AS order_count,
+  SUM(o.amount) AS total_amount
+FROM user u
+LEFT JOIN `order` o ON u.id = o.user_id
+WHERE u.level = 'vip' 
+  AND o.created_at >= DATE_SUB(NOW(), INTERVAL 1 MONTH)
+GROUP BY u.id, u.name, u.email
+HAVING order_count > 5
+ORDER BY total_amount DESC
+LIMIT 100;
+```
+
+执行时间：**12.3s**（`EXPLAIN` 显示全表扫 user 和 order）
+
+## 分析过程
+
+### Step 1: EXPLAIN 分析
+
+```sql
+EXPLAIN FORMAT=JSON
+SELECT 
+  u.id, u.name, u.email,
+  COUNT(o.id) AS order_count,
+  SUM(o.amount) AS total_amount
+FROM user u
+LEFT JOIN `order` o ON u.id = o.user_id
+WHERE u.level = 'vip' 
+  AND o.created_at >= DATE_SUB(NOW(), INTERVAL 1 MONTH)
+GROUP BY u.id, u.name, u.email
+HAVING order_count > 5
+ORDER BY total_amount DESC
+LIMIT 100;
+```
+
+**发现的问题**：
+1. `u.level` 没有索引 → type: ALL，全表扫描 50 万用户
+2. `o.created_at` 没有索引 → type: ALL，全表扫描 500 万订单
+3. `GROUP BY` 和 `ORDER BY` 没有索引覆盖 → Using temporary; Using filesort
+
+### Step 2: 添加索引
+
+```sql
+-- 1. user 表的 level 查询索引
+ALTER TABLE user ADD INDEX idx_level (level);
+
+-- 2. order 表的复合索引（user_id 用于 JOIN，created_at 用于时间过滤）
+ALTER TABLE `order` ADD INDEX idx_user_created (user_id, created_at);
+
+-- 3. 覆盖索引（减少回表）
+ALTER TABLE `order` ADD INDEX idx_user_created_amount (user_id, created_at, amount);
+```
+
+### Step 3: 优化后 EXPLAIN
+
+- `user` 表：type: ref（`idx_level`），rows: 5000（从 50 万降到 5000）
+- `order` 表：type: ref（`idx_user_created`），rows: 每用户约 10 行
+- Extra: 不再有 Using temporary; Using filesort
+
+## 优化后结果
+
+```sql
+-- 优化后查询
+SELECT 
+  u.id, u.name, u.email,
+  COUNT(o.id) AS order_count,
+  SUM(o.amount) AS total_amount
+FROM user u
+INNER JOIN `order` o ON u.id = o.user_id
+WHERE u.level = 'vip' 
+  AND o.created_at >= DATE_SUB(NOW(), INTERVAL 1 MONTH)
+GROUP BY u.id
+HAVING order_count > 5
+ORDER BY total_amount DESC
+LIMIT 100;
+```
+
+执行时间：**12.3s → 0.08s**（提升约 150 倍）
+
+## 优化要点总结
+
+| 优化项 | 优化前 | 优化后 | 效果 |
+|--------|--------|--------|------|
+| `level` 索引 | ALL（50万行） | ref（5000行） | 减少 99% 扫描 |
+| `(user_id, created_at)` 复合索引 | ALL（500万行） | ref（平均10行/用户） | 减少 99.99% |
+| `LEFT JOIN` 改为 `INNER JOIN` | 含无订单用户 | 仅含订单用户 | 减少数据处理量 |
+| `GROUP BY u.id`（简化列） | 3 列分组 | 1 列分组（id 唯一） | 减少临时表开销 |
+| 数据范围 | 全表扫描 | 索引范围扫描 | 大幅提高 |

package/skills/database/mysql/examples/03-master-slave-setup.md

@@ -0,0 +1,144 @@
+# 示例: 主从复制搭建
+
+## 场景
+
+为电商平台搭建一主一从架构，实现读写分离和基本高可用。主库处理 DML（写），从库处理 SELECT（读）。
+
+## 环境
+
+- Master: 192.168.1.100:3306
+- Slave: 192.168.1.101:3306
+- MySQL 8.0.x
+
+## 步骤
+
+### Step 1: Master 配置
+
+编辑 `/etc/my.cnf`：
+
+```ini
+[mysqld]
+server-id = 1
+log_bin = /var/log/mysql/mysql-bin
+binlog_format = ROW
+binlog_expire_logs_seconds = 604800
+sync_binlog = 1
+innodb_flush_log_at_trx_commit = 1
+```
+
+重启 MySQL：`systemctl restart mysqld`
+
+### Step 2: Master 创建复制用户
+
+```sql
+CREATE USER 'replicator'@'192.168.1.101' IDENTIFIED BY 'StrongPassword123!';
+GRANT REPLICATION SLAVE ON *.* TO 'replicator'@'192.168.1.101';
+FLUSH PRIVILEGES;
+```
+
+### Step 3: 记录 Master 二进制日志位置
+
+```sql
+FLUSH TABLES WITH READ LOCK;  -- 锁住所有表
+SHOW MASTER STATUS;
+-- 输出:
+-- File: mysql-bin.000042
+-- Position: 841236
+```
+
+> **注意**：新开一个终端会话执行 `SHOW MASTER STATUS`，不要在锁会话中执行，否则锁会一直持有。
+
+### Step 4: 初始数据同步
+
+```bash
+# 在 Master 上导出数据
+mysqldump -u root -p --all-databases --single-transaction --master-data=2 > /tmp/mysql_full.sql
+
+# 复制到 Slave
+scp /tmp/mysql_full.sql root@192.168.1.101:/tmp/
+
+# 解锁 Master
+UNLOCK TABLES;
+```
+
+### Step 5: Slave 配置
+
+编辑 `/etc/my.cnf`：
+
+```ini
+[mysqld]
+server-id = 2
+relay_log = /var/log/mysql/mysql-relay-bin
+read_only = 1
+log_slave_updates = 0          # 可选：记录从库更新到 binlog
+skip_slave_start = 1           # 防止自动启动复制
+```
+
+重启 MySQL：`systemctl restart mysqld`
+
+### Step 6: Slave 恢复初始数据
+
+```bash
+mysql -u root -p < /tmp/mysql_full.sql
+```
+
+### Step 7: 配置复制
+
+```sql
+CHANGE MASTER TO
+  MASTER_HOST = '192.168.1.100',
+  MASTER_PORT = 3306,
+  MASTER_USER = 'replicator',
+  MASTER_PASSWORD = 'StrongPassword123!',
+  MASTER_LOG_FILE = 'mysql-bin.000042',
+  MASTER_LOG_POS = 841236;
+
+START SLAVE;
+```
+
+### Step 8: 验证复制
+
+```sql
+SHOW SLAVE STATUS\G
+-- Slave_IO_Running: Yes
+-- Slave_SQL_Running: Yes
+-- Seconds_Behind_Master: 0
+```
+
+### Step 9: 测试
+
+```sql
+-- Master 上插入测试数据
+INSERT INTO test.replication_test VALUES (1, 'hello');
+
+-- Slave 上验证
+SELECT * FROM test.replication_test;  -- 应该看到数据
+```
+
+## 验证脚本
+
+```bash
+#!/bin/bash
+# check_replication.sh
+
+IO_STATUS=$(mysql -e "SHOW SLAVE STATUS\G" | grep "Slave_IO_Running" | awk '{print $2}')
+SQL_STATUS=$(mysql -e "SHOW SLAVE STATUS\G" | grep "Slave_SQL_Running" | awk '{print $2}')
+LAG=$(mysql -e "SHOW SLAVE STATUS\G" | grep "Seconds_Behind_Master" | awk '{print $2}')
+
+if [ "$IO_STATUS" = "Yes" ] && [ "$SQL_STATUS" = "Yes" ]; then
+    echo "Replication OK. Lag: ${LAG}s"
+    exit 0
+else
+    echo "Replication ERROR!"
+    exit 1
+fi
+```
+
+## 常见问题排查
+
+| 问题 | 检查 | 解决方案 |
+|------|------|---------|
+| Slave_IO_Running: Connecting | 网络连通性 | `ping 192.168.1.100`，检查防火墙 3306 |
+| Slave_IO_Running: No | 复制用户权限 | 检查 MASTER_USER/MASTER_PASSWORD |
+| 主键冲突 | 初始数据不一致 | `SET GLOBAL sql_slave_skip_counter = 1;` |
+| 复制延迟高 | Slave 性能 | 升级硬件、开启并行复制 |

package/skills/database/mysql/examples/04-backup-strategy.md

@@ -0,0 +1,212 @@
+# 示例: 生产环境备份策略
+
+## 场景
+
+日活 10 万用户的电商平台，MySQL 总数据量约 200GB，需要 24×7 运行，无法接受超过 30 分钟的数据丢失。
+
+## 备份策略
+
+```
+全量备份:    每天 02:00 (XtraBackup 物理备份)
+增量备份:    每 6 小时 (XtraBackup 增量)
+二进制日志:  实时归档 (自动备份到 S3)
+保留周期:    7 天全量 + 30 天增量 + 90 天 Binlog
+异地备份:    同步到阿里云 OSS (跨区域复制)
+恢复演练:    每月一次
+```
+
+## 备份脚本
+
+### 全量备份脚本
+
+```bash
+#!/bin/bash
+# /usr/local/bin/backup_full.sh
+
+BACKUP_DIR="/data/backup/mysql"
+DATE=$(date +%Y%m%d_%H%M%S)
+FULL_DIR="${BACKUP_DIR}/full/${DATE}"
+MYSQL_USER="backup_user"
+MYSQL_PASS="$(cat /etc/mysql/backup_pass)"
+
+# 创建备份目录
+mkdir -p ${FULL_DIR}
+
+# 执行 XtraBackup 全量备份
+xtrabackup --backup \
+  --user=${MYSQL_USER} \
+  --password=${MYSQL_PASS} \
+  --target-dir=${FULL_DIR} \
+  --compress \
+  --compress-threads=4 \
+  --parallel=4 2>>/var/log/xtrabackup.log
+
+if [ $? -eq 0 ]; then
+  echo "[$(date)] Full backup completed: ${FULL_DIR}" >> /var/log/backup.log
+  
+  # 同步到 OSS
+  ossutil sync ${FULL_DIR} oss://myapp-backup/mysql/full/${DATE}/ \
+    --delete --force 2>>/var/log/oss_backup.log
+    
+  # 清理 7 天前的全量备份
+  find ${BACKUP_DIR}/full/ -type d -mtime +7 -exec rm -rf {} \;
+  echo "[$(date)] Full backup synced to OSS" >> /var/log/backup.log
+else
+  echo "[$(date)] Full backup FAILED!" >> /var/log/backup.log
+  curl -X POST -H "Content-Type: application/json" \
+    -d '{"msg":"MySQL 全量备份失败"}' \
+    https://alert.example.com/notify
+fi
+```
+
+### 增量备份脚本
+
+```bash
+#!/bin/bash
+# /usr/local/bin/backup_inc.sh
+
+BACKUP_DIR="/data/backup/mysql"
+DATE=$(date +%Y%m%d_%H%M%S)
+INC_DIR="${BACKUP_DIR}/inc/${DATE}"
+MYSQL_USER="backup_user"
+MYSQL_PASS="$(cat /etc/mysql/backup_pass)"
+LATEST_FULL=$(ls -td ${BACKUP_DIR}/full/*/ | head -1)
+
+# 找最近的备份作为增量基准备份
+if [ -z "$(ls -A ${BACKUP_DIR}/inc/ 2>/dev/null)" ]; then
+  BASEDIR="${LATEST_FULL}"
+else
+  BASEDIR=$(ls -td ${BACKUP_DIR}/inc/*/ | head -1)
+fi
+
+mkdir -p ${INC_DIR}
+
+xtrabackup --backup \
+  --user=${MYSQL_USER} \
+  --password=${MYSQL_PASS} \
+  --target-dir=${INC_DIR} \
+  --incremental-basedir=${BASEDIR} \
+  --compress \
+  --compress-threads=4 \
+  --parallel=4 2>>/var/log/xtrabackup.log
+
+if [ $? -eq 0 ]; then
+  echo "[$(date)] Incremental backup completed" >> /var/log/backup.log
+  ossutil sync ${INC_DIR} oss://myapp-backup/mysql/inc/${DATE}/ \
+    --delete --force 2>>/var/log/oss_backup.log
+  find ${BACKUP_DIR}/inc/ -type d -mtime +30 -exec rm -rf {} \;
+else
+  echo "[$(date)] Incremental backup FAILED!" >> /var/log/backup.log
+  curl -X POST -H "Content-Type: application/json" \
+    -d '{"msg":"MySQL 增量备份失败"}' \
+    https://alert.example.com/notify
+fi
+```
+
+### Binlog 实时归档
+
+```bash
+#!/bin/bash
+# /usr/local/bin/archive_binlog.sh
+
+BINLOG_DIR="/var/log/mysql"
+ARCHIVE_DIR="/data/backup/binlog"
+FILES=($(ls -1t ${BINLOG_DIR}/mysql-bin.* 2>/dev/null))
+
+# 排除当前正在使用的 binlog
+CURRENT=$(mysql -e "SHOW MASTER STATUS\G" | grep File | awk '{print $2}')
+for FILE in "${FILES[@]}"; do
+  BASENAME=$(basename $FILE)
+  if [ "$BASENAME" != "$CURRENT" ] && [ ! -f "${ARCHIVE_DIR}/${BASENAME}.gz" ]; then
+    gzip -c $FILE > ${ARCHIVE_DIR}/${BASENAME}.gz
+    ossutil cp ${ARCHIVE_DIR}/${BASENAME}.gz oss://myapp-backup/binlog/
+    echo "[$(date)] Archived: ${BASENAME}" >> /var/log/binlog_archive.log
+    
+    # 删除本地归档后的 binlog 释放空间
+    mysql -e "PURGE BINARY LOGS BEFORE DATE_SUB(NOW(), INTERVAL 7 DAY);"
+  fi
+done
+```
+
+## 恢复流程
+
+### 完整恢复步骤
+
+```bash
+#!/bin/bash
+# /usr/local/bin/restore_mysql.sh
+
+RESTORE_DATE=$1  # 格式: 2024-03-15 10:30:00
+
+# 1. 从 OSS 下载最近的全量备份
+ossutil cp -r oss://myapp-backup/mysql/full/latest/ /tmp/restore/full/
+echo "Step 1: Full backup downloaded"
+
+# 2. 准备全量备份
+xtrabackup --prepare --target-dir=/tmp/restore/full/ --apply-log-only
+echo "Step 2: Full backup prepared"
+
+# 3. 按需合并增量备份
+for inc in $(ossutil ls oss://myapp-backup/mysql/inc/ | sort); do
+  ossutil cp -r $inc /tmp/restore/inc/
+  xtrabackup --prepare --target-dir=/tmp/restore/full/ \
+    --incremental-dir=/tmp/restore/inc/ --apply-log-only
+  echo "Step 3: Incremental ${inc} merged"
+done
+
+# 4. 最终准备（非 apply-log-only，回滚未提交事务）
+xtrabackup --prepare --target-dir=/tmp/restore/full/
+echo "Step 4: Final prepare done"
+
+# 5. 停止 MySQL，替换数据目录
+systemctl stop mysqld
+mv /var/lib/mysql /var/lib/mysql_bak
+xtrabackup --copy-back --target-dir=/tmp/restore/full/
+chown -R mysql:mysql /var/lib/mysql
+echo "Step 5: Data restored"
+
+# 6. 启动 MySQL
+systemctl start mysqld
+echo "Step 6: MySQL started"
+
+# 7. 回放 Binlog 到指定时间点（PITR）
+mysqlbinlog --stop-datetime="${RESTORE_DATE}" \
+  /data/backup/binlog/mysql-bin.* | mysql -u root -p
+echo "Step 7: PITR applied to ${RESTORE_DATE}"
+```
+
+## 定时作业配置
+
+```bash
+# crontab -e
+
+# 每天 02:00 全量备份
+0 2 * * * /usr/local/bin/backup_full.sh
+
+# 每 6 小时增量备份
+0 */6 * * * /usr/local/bin/backup_inc.sh
+
+# 每小时检查并归档 binlog
+0 * * * * /usr/local/bin/archive_binlog.sh
+
+# 每天 06:00 检查备份完整性
+0 6 * * * /usr/local/bin/check_backup.sh
+```
+
+## 恢复演练计划
+
+```
+每月第一周周日凌晨 2:00 执行：
+
+1. 在测试环境恢复最近的全量备份
+2. 应用增量备份
+3. 执行 PITR 到指定时间点
+4. 验证数据完整性：
+   - 检查关键表行数
+   - 验证最近订单数据
+   - 运行业务自检脚本
+5. 记录恢复耗时，持续优化
+
+目标 RTO: < 2 小时
+目标 RPO: < 30 分钟
+```

package/skills/database/mysql/references/01-functions-string.md

@@ -0,0 +1,103 @@
+# 字符串函数 (String Functions)
+
+## 简介
+
+MySQL 提供丰富的字符串处理函数，用于字符串拼接、截取、替换、格式化等操作。这些函数在数据清洗、脱敏、报表生成中广泛使用。
+
+## 常用函数速查
+
+### 拼接与格式化
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `CONCAT(s1, s2, ...)` | 字符串拼接 | `CONCAT(first_name, ' ', last_name)` | 'John Doe' |
+| `CONCAT_WS(sep, s1, s2)` | 带分隔符拼接 | `CONCAT_WS('-', '2024', '01', '15')` | '2024-01-15' |
+| `GROUP_CONCAT(col)` | 分组拼接 | `GROUP_CONCAT(name ORDER BY id SEPARATOR ',')` | 'a,b,c' |
+| `FORMAT(x, d)` | 千分位格式化 | `FORMAT(12345.67, 2)` | '12,345.67' |
+| `LPAD(s, n, pad)` | 左填充 | `LPAD('7', 3, '0')` | '007' |
+| `RPAD(s, n, pad)` | 右填充 | `RPAD('7', 3, '0')` | '700' |
+
+### 截取与定位
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `SUBSTRING(s, pos, len)` | 子串 | `SUBSTRING('Hello World', 1, 5)` | 'Hello' |
+| `LEFT(s, n)` | 左截取 | `LEFT('abcde', 3)` | 'abc' |
+| `RIGHT(s, n)` | 右截取 | `RIGHT('abcde', 2)` | 'de' |
+| `LOCATE(sub, s, pos)` | 子串位置 | `LOCATE('is', 'this is test')` | 3 |
+| `INSTR(s, sub)` | 子串位置 | `INSTR('this is test', 'is')` | 3 |
+| `SUBSTRING_INDEX(s, delim, n)` | 按分隔符截取 | `SUBSTRING_INDEX('a,b,c', ',', 2)` | 'a,b' |
+
+### 替换与转换
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `REPLACE(s, from, to)` | 替换 | `REPLACE('abc123', '123', '456')` | 'abc456' |
+| `INSERT(s, pos, len, new)` | 插入替换 | `INSERT('phone', 2, 4, '****')` | 'p****e' |
+| `UPPER(s)` / `LOWER(s)` | 大小写转换 | `UPPER('abc')` | 'ABC' |
+| `TRIM(s)` | 去首尾空格 | `TRIM(' abc ')` | 'abc' |
+| `LTRIM(s)` / `RTRIM(s)` | 去左/右空格 | `LTRIM(' abc')` | 'abc' |
+| `REVERSE(s)` | 逆序 | `REVERSE('abc')` | 'cba' |
+| `REPEAT(s, n)` | 重复 | `REPEAT('x', 5)` | 'xxxxx' |
+
+### 长度与校验
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `LENGTH(s)` | 字节长度 | `LENGTH('你好')` | 6 (utf8mb4) |
+| `CHAR_LENGTH(s)` | 字符长度 | `CHAR_LENGTH('你好')` | 2 |
+| `BIT_LENGTH(s)` | 位长度 | `BIT_LENGTH('A')` | 8 |
+| `ORD(s)` | 首字符 ASCII | `ORD('A')` | 65 |
+| `ASCII(s)` | 首字符 ASCII | `ASCII('A')` | 65 |
+
+## 业务场景
+
+### 场景 1: 手机号脱敏
+
+```sql
+SELECT 
+  REPLACE(phone, SUBSTRING(phone, 4, 4), '****') AS masked_phone 
+FROM user;
+-- 138****0000
+
+-- 更推荐的做法（INSERT 函数）
+SELECT INSERT(phone, 4, 4, '****') AS masked_phone FROM user;
+```
+
+### 场景 2: 商品编号补零
+
+```sql
+SELECT CONCAT('PRD', LPAD(id, 5, '0')) AS product_no FROM product;
+-- PRD00001, PRD00002, ...
+```
+
+### 场景 3: 统计每个用户的所有订单号
+
+```sql
+SELECT user_id, 
+  GROUP_CONCAT(order_no ORDER BY created_at SEPARATOR ', ') AS order_list
+FROM `order`
+GROUP BY user_id;
+```
+
+### 场景 4: 检查邮箱格式
+
+```sql
+SELECT * FROM user WHERE LOCATE('@', email) = 0;
+```
+
+### 场景 5: JSON 字符串提取（旧版本兼容）
+
+```sql
+-- 在 MySQL 5.7 之前，JSON 字段用字符串存储时的提取方式
+SELECT 
+  SUBSTRING_INDEX(SUBSTRING_INDEX(attrs, '"color":"', -1), '"', 2) AS color
+FROM product;
+```
+
+## 注意事项
+
+- `LENGTH()` 返回**字节数**而非字符数，对于多字节字符集（utf8mb4）一个中文字符占 3-4 字节
+- `CHAR_LENGTH()` 返回**字符数**，处理中文时使用此函数
+- `GROUP_CONCAT` 的结果长度受 `group_concat_max_len` 限制（默认 1024）
+- MySQL 字符串索引默认从 **1** 开始（非 0）

package/skills/database/mysql/references/02-functions-date.md

@@ -0,0 +1,152 @@
+# 日期时间函数 (Date & Time Functions)
+
+## 简介
+
+MySQL 的日期时间函数用于获取当前时间、提取日期组件、格式化和计算日期差。在报表统计、时间范围查询、过期计算等场景中高频使用。
+
+## 常用函数速查
+
+### 获取当前日期时间
+
+| 函数 | 说明 | 示例结果 |
+|------|------|---------|
+| `NOW()` | 当前日期时间 | '2024-03-15 14:30:00' |
+| `CURDATE()` | 当前日期 | '2024-03-15' |
+| `CURTIME()` | 当前时间 | '14:30:00' |
+| `UTC_DATE()` | UTC 当前日期 | '2024-03-15' |
+| `UTC_TIME()` | UTC 当前时间 | '06:30:00' |
+| `UTC_TIMESTAMP()` | UTC 当前日期时间 | '2024-03-15 06:30:00' |
+| `SYSDATE()` | 函数执行时的当前时间（非语句开始时间） | '2024-03-15 14:30:01' |
+| `CURRENT_TIMESTAMP` | NOW() 的同义词 | '2024-03-15 14:30:00' |
+
+### 提取日期/时间组件
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `DATE(expr)` | 提取日期部分 | `DATE(NOW())` | '2024-03-15' |
+| `TIME(expr)` | 提取时间部分 | `TIME(NOW())` | '14:30:00' |
+| `YEAR(date)` | 提取年 | `YEAR('2024-03-15')` | 2024 |
+| `MONTH(date)` | 提取月 | `MONTH('2024-03-15')` | 3 |
+| `DAY(date)` | 提取日 | `DAY('2024-03-15')` | 15 |
+| `HOUR(time)` | 提取时 | `HOUR('14:30:00')` | 14 |
+| `MINUTE(time)` | 提取分 | `MINUTE('14:30:00')` | 30 |
+| `SECOND(time)` | 提取秒 | `SECOND('14:30:00')` | 0 |
+| `EXTRACT(unit FROM date)` | 提取任意部分 | `EXTRACT(MONTH FROM '2024-03-15')` | 3 |
+
+### 日期运算
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `DATE_ADD(date, INTERVAL expr unit)` | 日期加法 | `DATE_ADD(NOW(), INTERVAL 7 DAY)` | 7 天后 |
+| `DATE_SUB(date, INTERVAL expr unit)` | 日期减法 | `DATE_SUB(NOW(), INTERVAL 1 MONTH)` | 上月同日 |
+| `DATEDIFF(d1, d2)` | 日期差（天） | `DATEDIFF('2024-03-20', '2024-03-15')` | 5 |
+| `TIMESTAMPDIFF(unit, d1, d2)` | 灵活时间差 | `TIMESTAMPDIFF(HOUR, '2024-01-01', NOW())` | 小时数 |
+| `LAST_DAY(date)` | 月末日期 | `LAST_DAY('2024-02-01')` | '2024-02-29' |
+
+**支持的时间单位**：`MICROSECOND`, `SECOND`, `MINUTE`, `HOUR`, `DAY`, `WEEK`, `MONTH`, `QUARTER`, `YEAR`
+
+### 格式化与转换
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `DATE_FORMAT(date, fmt)` | 日期格式化 | `DATE_FORMAT(NOW(), '%Y年%m月%d日')` | '2024年03月15日' |
+| `TIME_FORMAT(t, fmt)` | 时间格式化 | `TIME_FORMAT('14:30:00', '%H:%i')` | '14:30' |
+| `STR_TO_DATE(str, fmt)` | 字符串转日期 | `STR_TO_DATE('2024-03-15', '%Y-%m-%d')` | 2024-03-15 |
+| `UNIX_TIMESTAMP([date])` | 转 Unix 时间戳 | `UNIX_TIMESTAMP('2024-03-15')` | 1710489600 |
+| `FROM_UNIXTIME(ts)` | 时间戳转日期 | `FROM_UNIXTIME(1710489600)` | '2024-03-15 00:00:00' |
+
+**DATE_FORMAT 常用格式符**：
+
+| 格式符 | 说明 | 示例 |
+|--------|------|------|
+| `%Y` | 四位年份 | 2024 |
+| `%y` | 两位年份 | 24 |
+| `%m` | 两位月份 | 03 |
+| `%c` | 月份（无前导零） | 3 |
+| `%d` | 两位日期 | 15 |
+| `%e` | 日期（无前导零） | 15 |
+| `%H` | 24 小时制（00-23） | 14 |
+| `%h` / `%I` | 12 小时制（01-12） | 02 |
+| `%i` | 分钟（00-59） | 30 |
+| `%s` | 秒（00-59） | 00 |
+| `%W` | 星期名称 | Friday |
+| `%M` | 月份名称 | March |
+| `%a` | 缩写星期 | Fri |
+| `%b` | 缩写月份 | Mar |
+
+### 星期与周
+
+| 函数 | 说明 | 示例 | 结果 |
+|------|------|------|------|
+| `WEEKDAY(date)` | 周索引 (0=Mon, 6=Sun) | `WEEKDAY('2024-03-18')` | 0 (周一) |
+| `DAYOFWEEK(date)` | 周索引 (1=Sun, 7=Sat) | `DAYOFWEEK('2024-03-18')` | 2 (周一) |
+| `DAYNAME(date)` | 星期名 | `DAYNAME('2024-03-18')` | 'Monday' |
+| `MONTHNAME(date)` | 月份名 | `MONTHNAME('2024-03-18')` | 'March' |
+| `WEEK(date[, mode])` | 周数 | `WEEK('2024-03-18')` | 12 |
+| `WEEKOFYEAR(date)` | ISO 周数 | `WEEKOFYEAR('2024-03-18')` | 12 |
+| `QUARTER(date)` | 季度 | `QUARTER('2024-03-18')` | 1 |
+| `DAYOFYEAR(date)` | 一年中的第几天 | `DAYOFYEAR('2024-03-18')` | 78 |
+
+## 业务场景
+
+### 场景 1: 本月、本周、本日统计
+
+```sql
+-- 本月注册用户
+SELECT COUNT(*) FROM user
+WHERE created_at >= DATE_FORMAT(CURDATE(), '%Y-%m-01');
+
+-- 本周注册用户（周一为一周开始）
+SELECT COUNT(*) FROM user
+WHERE created_at >= DATE_SUB(CURDATE(), INTERVAL WEEKDAY(CURDATE()) DAY);
+
+-- 今日统计
+SELECT COUNT(*) FROM `order`
+WHERE DATE(created_at) = CURDATE();
+```
+
+### 场景 2: 按年月聚合
+
+```sql
+SELECT 
+  DATE_FORMAT(created_at, '%Y-%m') AS month, 
+  COUNT(*) AS order_count,
+  SUM(amount) AS total_revenue
+FROM `order`
+GROUP BY month
+ORDER BY month;
+```
+
+### 场景 3: 计算用户注册天数
+
+```sql
+SELECT id, name, 
+  DATEDIFF(NOW(), created_at) AS days_since_reg 
+FROM user;
+```
+
+### 场景 4: 计算任务耗时
+
+```sql
+SELECT task_id, 
+  TIMESTAMPDIFF(SECOND, start_time, end_time) AS duration_seconds
+FROM task;
+```
+
+### 场景 5: 上月同期对比
+
+```sql
+SELECT 
+  DATE_FORMAT(created_at, '%Y-%m-%d') AS day,
+  COUNT(*) AS orders_today
+FROM `order`
+WHERE created_at >= DATE_SUB(DATE_SUB(CURDATE(), INTERVAL 1 MONTH), INTERVAL WEEKDAY(DATE_SUB(CURDATE(), INTERVAL 1 MONTH)) DAY)
+  AND created_at < CURDATE();
+```
+
+## 注意事项
+
+- `DATETIME` vs `TIMESTAMP`：`TIMESTAMP` 会自动时区转换，范围仅到 2038 年
+- `NOW()` 和 `SYSDATE()` 的区别：`NOW()` 返回语句开始的时刻，`SYSDATE()` 返回函数执行时的时刻
+- MySQL 5.6.4+ 支持毫秒精度：`NOW(3)`, `CURTIME(6)`
+- 日期函数中使用 `DATE()` 包裹列会导致索引失效（应改用范围查询）