我习惯把家里那台 MacBook 当编码机。人在公司或者在外面,随时连回去接着 vibe coding,SSH 也好,远程桌面也好,连上就能干活。可这台机器很守规矩,几分钟没人动,屏幕先黑,再过一会儿整个系统就睡了。人不在家,连接一断,只能干瞪眼。

让它别睡,macOS 自带一个工具叫 caffeinate。我在这台机器上(Apple Silicon,macOS 26)把每个参数挨个试了一遍,文中标 【实测】 的都是真试出来的结论,和手册说法有出入的地方,以实测为准。

一、先弄懂原理,电脑为什么会自己睡

macOS 决定要不要睡之前,会先看有没有进程举手说"别睡"。系统里管这个叫电源断言(Power Assertion),名字不用记,它就是一句"别睡"的登记。

caffeinate 就是官方的"举手工具"。你给它什么参数,它就替你举什么手。命令活着,手就一直举着;命令退出,手自动放下,系统该睡就睡。

一个举手能不能拦住系统,还得看插没插电源。这是全文最重要的主题,见第五节。

二、各个参数的含义

-d 防屏幕睡眠

  • 举的手:PreventUserIdleDisplaySleep(别关屏幕)
  • 【实测】只用电池时,系统不把这条申请当回事,屏幕照样会灭,插电才可靠
  • 屏幕是耗电大户,整夜常亮是耗干电池最快的办法

-i 防系统空闲睡眠

  • 举的手:PreventUserIdleSystemSleep(系统别睡)
  • 把"没人动就睡"这个条件去掉,下载、编译继续跑。最核心、最常用,【实测】插电电池都有效
  • 屏幕可以正常关闭,这是好事,省电。系统醒着干活,远程照样连得上

-m 防磁盘睡眠

  • 举的手:PreventSystemDiskSleep
  • 老式机械硬盘才需要它。【实测】Apple Silicon 上系统根本不给建这条申请,直接报"不支持"(错误码 -536870206)。SSD 没有停转一说,macOS 已废弃
  • 结论:Apple Silicon 上可以忽略

-s 防系统睡眠(仅限插电)

  • 举的手:PreventSystemSleep
  • 拦住一切睡眠,连合盖也拦。只在插着电源时有效,电池下无效,手册明说
  • 和 -i 的区别:-i 防"闲了睡",-s 防得更彻底但仅限插电。插电时 -is 一起用最稳

-u 声明"用户活跃"

  • 举的手:UserIsActive
  • 假装你动了一下鼠标键盘,默认只保持 5 秒。常配 -t 用:caffeinate -u -t 3600 就是装一小时
  • 场景:开会、演示、短暂离开

-t <秒数> 超时自动退出

  • 例子:caffeinate -i -t 3600,防睡 1 小时后自动放手。不加就一直举到手动 Ctrl+C
  • 忘了关也不会永远跑着,推荐习惯性带上

-w <pid> 等某个程序结束

  • 任务已经在跑时用它:pgrep 查到进程号,再 caffeinate -i -w <PID>,程序退出自动放手
  • 比定时更精准,任务跑多久防多久

直接包裹命令(最省事)

命令还没启动的话,直接跟在后面:

caffeinate -i python train.py

等这条命令跑完自动放手。能用这种写法就用它,-w 留给任务已经在跑的场景。

不带任何参数

caffeinate 单独跑等于默认 -i(防系统空闲睡眠)。

三、组合与场景

常用组合速查

命令屏幕会灭吗系统睡吗适用场景备注
caffeinate -i -t 3600✅ 正常灭1 小时内不睡挂机跑任务,插电/电池皆可日常推荐,带超时保险
caffeinate -i python train.py✅ 正常灭任务期间不睡启动时就套上,跑完自动恢复最省事的任务级防睡
caffeinate -i -w <PID>✅ 正常灭任务期间不睡编译/下载/训练,干完自动恢复任务已在跑时用这个
caffeinate -is✅ 正常灭不睡插电 + 合盖,家里 Mac 当远程编码机【实测】插电时合盖不睡
caffeinate -dims不灭(插电时)不睡没有专属场景看着唬人,实际等效 -is 还多费屏幕的电
caffeinate -u -t 180030 分钟内像有人在用同左开会/演示/短时离开到点自动恢复

场景详解

场景 1:合盖当远程编码机(本文主角),caffeinate -is + 插电

插电时 -s 生效,合盖系统继续醒着,人在外面照样连上来 vibe coding。【实测】可用。务必插电,一是 -s 只认插电,二是合盖散热差,整夜功耗交给市电。屏幕黑着不用担心,远程连的是系统,不是屏幕。

场景 2:临时挂机 2 小时,caffeinate -i -t 7200

电池也有效。屏幕正常关闭省电,到点自动放手。

场景 3:跟着任务走

caffeinate -i python train.py   # 还没启动,直接包裹
caffeinate -i -w $!             # 已经在跑,等它的进程号

任务结束,防睡自动结束,不会忘记关。

四、开机自动防睡,不用每次手动敲

每次登录敲一遍太麻烦。Mac 自带开机自启机制 LaunchAgent,把 caffeinate 注册进去,开机自动跑,不用再管。

存成 ~/Library/LaunchAgents/com.yourname.caffeinate.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.yourname.caffeinate</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/caffeinate</string>
        <string>-is</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

加载它,不用重启机器:

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.yourname.caffeinate.plist

RunAtLoad 是加载时立刻跑。KeepAlive 是关键,进程被杀掉会自动拉回。我实测过,不加它,kill 之后进程就死了,等于白装。

想停止:

launchctl bootout gui/$(id -u)/com.yourname.caffeinate

三个坑:

  • 重启后要有人登录过才生效。LaunchAgent 按用户登录加载,停在登录界面时它还没跑。远程场景记得在系统设置里开自动登录
  • caffeinate 要写全路径 /usr/bin/caffeinate,launchd 不读你的 shell 配置
  • KeepAlive 会让进程 kill 不掉,要停就先 launchctl bootout

嫌 KeepAlive: true 太死板、想保留手动杀进程的自由,就换成 SuccessfulExit: false,正常退出不再拉起,崩溃时才自动重启,实测可用。

五、什么时候有用,什么时候没用

✅ 有用的前提

  1. 插着电源,所有申请都最可靠,-s 只在插电时存在
  2. 防的对象是空闲睡眠(没人动、到时间了)
  3. 合盖场景(插电 + -s,【实测】有效)

❌ 没用 / 救不了的情况(每一条都有实测教训)

情况为什么没用
电池耗尽防睡管"睡不睡",管不了"还有没有电"。电量剩 1% 时硬件强制断电,什么命令都拦不住。【实测】两次深夜没电关机都是这个
-d 用电池防屏幕【实测】电池下系统不把屏幕申请当回事,屏幕照灭
-m 在 Apple Silicon 上【实测】申请直接被拒绝,等于没写
没插电却以为插着电命令照常跑,电池在悄悄掉。充电器松了、被拔了,caffeinate 不会提醒你
用户主动关机 / 电池下合盖你亲手关机、合盖,它不拦
系统睡着之后申请必须在睡前举好,系统睡了命令才想起来跑,没用

⚠️ 容易误解的点

  • 防睡 ≠ 防断电。工具保证"系统醒着",前提是"电够"。跑长任务请插电
  • 防睡 ≠ 省电。系统整夜醒着,不干活也在费电。防睡命令跑一整夜电池,就是昨晚的结局,睡前 100%,早上剩 1%
  • 锁屏、灭屏、睡眠是三件事。灭屏、锁屏时系统都还醒着,terminal 里跑的任务照常跑,真正让任务停下来的是睡眠。caffeinate 管睡不睡,管不了锁屏,-d 也防不了你手动锁屏。远程场景要防的是睡眠,-i 或 -s 才是对口的参数

六、怎么验证它真的在工作

# 1. 看申请在谁手里(能看到进程名、类型、已持有时长)
pmset -g assertions

# 2. 看系统为什么睡/为什么没睡(排查利器)
pmset -g log | grep -Ei "sleep|wake" | tail -30

# 3. 看当前电源来源(插电还是电池)
pmset -g batt

开启 caffeinate 后跑第 1 条,看到 caffeinate 名下有申请就是生效了;关掉后再看,申请消失。

七、一页速记

# 家里 Mac 合盖在线,出门远程 vibe coding(插电!)
caffeinate -is

# 让它开机自动跑,见第四节
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.yourname.caffeinate.plist

# 日常挂机(带 2 小时保险)
caffeinate -i -t 7200

# 跑一个命令,跑完自动停
caffeinate -i python train.py

# 演示模式 30 分钟
caffeinate -u -t 1800

记住三句话。

  1. 插电是所有组合的地基,跑长任务必插电
  2. -i 是唯一用电池也可靠的防睡参数,其余按需叠加
  3. -t 和 -w 是保险丝,让防睡有终点,忘了关也不出事