如何让 Vibe Coding 时候 Mac 不睡眠
我习惯把家里那台 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 1800 | 30 分钟内像有人在用 | 同左 | 开会/演示/短时离开 | 到点自动恢复 |
场景详解
场景 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,正常退出不再拉起,崩溃时才自动重启,实测可用。
五、什么时候有用,什么时候没用
✅ 有用的前提
- 插着电源,所有申请都最可靠,
-s只在插电时存在 - 防的对象是空闲睡眠(没人动、到时间了)
- 合盖场景(插电 +
-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
记住三句话。
- 插电是所有组合的地基,跑长任务必插电
-i是唯一用电池也可靠的防睡参数,其余按需叠加-t和-w是保险丝,让防睡有终点,忘了关也不出事