# Time Machine · 排除与纳入清单

> 更新：2026-06-04 | 金仓

## 必须纳入备份（勿排除）

| 路径 | 体量（约） | 状态 |
|:---|:---|:---|
| `~/Documents/个人`（含卡若AI） | 大 | **Included** |
| `~/Documents/开发` | **~58GB**（源码进；`node_modules` 等不进） | **Included** |
| `~/数据库`（配置/脚本等） | 部分 | **纳入** |
| `~/数据库/mongodb/data` | **~71GB** | **Excluded**（运行中 · 防 TM 卡死） |
| `~/数据库/mysql` | **~9.5GB** | **Excluded**（Docker MySQL 在写） |
| Docker `Data/vms` / `Docker.raw` | **~27GB** | **Excluded**（VM 热盘） |
| 微信 `com.tencent.xinWeChat` | ~77GB | **Included**（脚本永不排除） |
| Docker `com.docker.docker` 等 | **~27GB** | **Included**（已取消排除） |

> MongoDB 运行中备份可能不一致；重要库另有 NAS/腾讯云同步（G13a）。TM 作整机兜底。

## 固定排除（`tm_lan_speed_boost.sh`）

| 路径 | 原因 |
|:---|:---|
| ~~`~/Documents/开发`~~ | **目录已纳入**；其下 `node_modules`/`.git` 等仍单独排除 |
| `~/Library/Mobile Documents` | iCloud 小文件极多 |
| `~/Library/CloudStorage` | 云盘同步目录 |
| `~/Library/Application Support/MobileSync` | iOS 备份 |
| `~/Library/Caches` | 缓存可重建 |
| `~/Library/pnpm` / `~/.npm` | 包缓存 |
| `~/Library/Group Containers` | 容器缓存 |
| `~/Library/Logs` | 日志 |
| `~/Library/Application Support/Cursor` | IDE 缓存 |
| ~~`~/Library/Containers/com.docker.docker`~~ | **已纳入备份** |
| `~/Library/Developer/Xcode/DerivedData` | 编译产物 |
| `~/Library/Developer/CoreSimulator` | 模拟器 |
| `~/Downloads` | 下载目录 |
| `~/.Trash` / `~/.local/share/Trash` | 废纸篓 |
| `~/.gradle/caches` / `~/.m2/repository` / `~/.cache` | 构建缓存 |

## 动态排除（find 扫描，最多 200 项）

在 `~/Documents`、`~/Library` 下匹配且**已排除**的目录名：

`node_modules` · `.git` · `__pycache__` · `.venv` / `venv` · `dist` / `build` · `.next` / `.nuxt` · `target` · `.turbo` · `.parcel-cache` · `.pytest_cache` · `.tox`

（不含微信路径）

## 可选排除

| 环境变量 | 路径 |
|:---|:---|
| `TM_EXCLUDE_PHOTOS=1` | `~/Pictures/Photos Library.photoslibrary` |

## 恢复纳入备份

```bash
sudo tmutil removeexclusion -p "/路径"
# 若有 xattr：
sudo xattr -d com.apple.metadata:com_apple_backup_excludeItem "/路径"
```