---
title: "caffeinate"
type: concept
tags: [macOS, 电源管理, 临时防止睡眠]
---

# caffeinate

> macOS 临时防止系统睡眠的工具，不修改系统持久设置，按 Ctrl+C 停止。

## 概述

`caffeinate` 是 macOS 内置命令，用于在当前会话中临时防止系统进入睡眠状态。与 `pmset` 的永久配置不同，`caffeinate` 是即时生效、即时失效的临时方案，适合需要短期保持唤醒但不想修改系统设置的场景。

## 核心参数

| 参数 | 作用 |
|------|------|
| `-d` | 防止显示器睡眠 |
| `-i` | 防止系统空闲时睡眠 |
| `-s` | 防止系统睡眠（防止 AC Power 断开时进入睡眠） |
| `-u` | 模拟用户活动（防止睡眠） |
| `-t <secs>` | 指定超时秒数后允许睡眠 |

## 常用命令

```bash
# 防止显示器和系统睡眠（常用组合）
caffeinate -d -i -s

# 按 Ctrl+C 停止
```

## 使用场景

1. **临时测试**：验证某操作是否需要系统保持唤醒
2. **一次性任务**：执行大文件传输、备份等不希望被睡眠中断的任务
3. **替代 pmset**：不修改系统电源设置，仅在需要时保持唤醒
4. **与 pmset 对比**：pmset 永久配置 vs caffeinate 临时生效

## 与 pmset 的关系

- **pmset**：永久修改系统电源设置，重启后保留
- **caffeinate**：临时阻止睡眠，不修改系统设置，退出后恢复原状态
- 两者可互补使用：先用 pmset 配置合理的系统默认行为，再用 caffeinate 处理临时需求

## Home Server 场景

在 Mac Mini 作为 Home Server 时，`caffeinate` 通常不是首选方案，因为服务器需要长期持续运行，`pmset` 的永久配置更适合。但 `caffeinate` 可用于：
- 调试电源管理配置
- 临时升级/维护期间的保持唤醒

## 相关概念

- [[pmset]] — macOS 电源管理永久配置工具
- [[系统睡眠管理]] — 操作系统电源管理的通用框架
- [[Headless 服务器]] — caffeinate 的目标运行环境

## 相关实体

- [[Mac Mini M4]] — caffeinate 的典型应用平台