Files
nexus/wiki/concepts/caffeinate.md
2026-04-22 08:02:59 +08:00

62 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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 的典型应用平台