---
title: "caffeinate：從終端機讓 Mac 保持喚醒 · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/caffeinate-keep-mac-awake.html"
description: "使用內建的 caffeinate 指令，讓 Mac 在下載、建置或執行腳本時不進入睡眠，並查看哪些 App 讓它保持喚醒。"
---

睡眠與電源

# 用 caffeinate 從終端機讓 Mac 保持喚醒

`caffeinate` 指令可以在工作執行期間防止 Mac 進入睡眠。它是 macOS 的一部分，不會更改任何設定。

適用於：所有目前的 macOS 版本。「系統設定」路徑適用於 macOS 13 Ventura 以上版本。 · 檢查日期：2026年10月29日

## 症狀

- Mac 進入睡眠後，下載、建置或腳本就停止了。
- 遠端工作階段或 SSH 連線在一段時間沒有輸入後中斷。
- 你想讓 Mac 在某個工作期間保持喚醒，但不想更改睡眠設定。

## 可能原因

- **閒置睡眠。**一段時間沒有鍵盤或滑鼠輸入後，macOS 會讓 Mac 進入睡眠。光是網路活動不一定能阻止這件事。
- **顯示器睡眠。**顯示器會依自己的計時器關閉。在某些 Mac 上，系統接著也會進入睡眠。
- **螢幕蓋。**闔上 Mac 筆電的螢幕會讓它進入睡眠，`caffeinate` 無法改變這一點。請參閱[闔上螢幕時讓 Mac 筆電繼續運作](https://kilobat.app/zh-hant/guides/clamshell-lid-closed-mac.html)。

## 如何檢查

1. 打開終端機，查看目前有哪些處理程序在阻止睡眠。

   ```
   pmset -g assertions
   ```

   輸出一份斷言列表，例如 `PreventUserIdleSystemSleep`，並列出持有每個斷言的處理程序。
2. 查看目前使用中的睡眠設定。

   ```
   pmset -g
   ```

## 如何修正

1. 若要在某個指令執行期間讓 Mac 保持喚醒，請在指令前面加上 `caffeinate -i`。指令結束時，斷言也會跟著結束。

   ```
   caffeinate -i make
   ```
2. 若要讓 Mac 保持喚醒一段固定時間，請用 `-t` 指定秒數。這個範例是兩小時。

   ```
   caffeinate -i -t 7200
   ```
3. 若要讓 Mac 保持喚醒直到某個處理程序結束，請用 `-w` 指定它的處理程序 ID。

   ```
   caffeinate -i -w 12345
   ```
4. 若也要讓顯示器保持開啟，請加上 `-d`。

   ```
   caffeinate -d -i
   ```
5. 若要停止不帶指令啟動的 `caffeinate`，請按 Control-C。
6. 若要在顯示器關閉時停止自動睡眠，請更改設定。在 Mac 筆電上，選擇「蘋果」選單 >「系統設定」>「電池」>「選項」，開啟「使用電源轉接器時，在顯示器關閉時防止自動進入睡眠」。
7. 在 Mac 桌上型電腦上，選擇「蘋果」選單 >「系統設定」>「能源」，開啟「在顯示器關閉時防止自動進入睡眠」。

## 使用 Kilobat

1. Kilobat 可以讓 Mac 保持喚醒，直到下載變得安靜，再讓它進入睡眠。從選單列打開 Kilobat，按一下茶杯，然後選擇「直到下載完成」。
2. CLI 也能做到同樣的事。速度低於 16 KB/s 持續 3 分鐘後就會停止。

   ```
   kilobat awake --until-quiet
   ```
3. 若要在某個指令執行期間讓 Mac 保持喚醒，並查看它傳輸的資料量，請使用 `awake --`。

   ```
   kilobat awake -- make release
   ```
4. 這些功能都是免費的。App、CLI 和 MCP 的步驟請參閱[實用技巧](https://kilobat.app/zh-hant/guides/recipes/keep-mac-awake-download.html)。

## 常見問題

**caffeinate 能讓 Mac 在闔上螢幕時保持喚醒嗎？**

不能。`caffeinate` 只阻止閒置睡眠。闔上螢幕仍然會讓 Mac 筆電進入睡眠，除非 Mac 接上了外接顯示器、鍵盤和電源。請參閱[闔上螢幕時讓 Mac 筆電繼續運作](https://kilobat.app/zh-hant/guides/clamshell-lid-closed-mac.html)。

**-s 選項有什麼作用？**

`-s` 會阻止系統睡眠。man 頁面說明它只在 Mac 使用 AC 電源時有效。

**caffeinate 會更改我的設定嗎？**

不會。它建立的是電源斷言，`caffeinate` 結束時斷言也會跟著結束。

## 資料來源

- caffeinate(8)，macOS 27.2 內建的 man 頁面
- pmset(1)，macOS 27.2 內建的 man 頁面
- [Apple 支援：設定 Mac 的睡眠與喚醒設定](https://support.apple.com/guide/mac-help/prevent-your-mac-from-sleeping-mchle41a6ccd/mac)

資料來源檢查日期：2026年10月29日。man 頁面為 macOS 內建版本；在終端機中用 `man <name>` 開啟。

## 相關指南

- [讓 Mac 保持喚醒直到下載完成](https://kilobat.app/zh-hant/guides/recipes/keep-mac-awake-download.html): 傳輸進行時，Kilobat 會讓 Mac 保持喚醒。
- [Mac 睡眠導致下載中斷](https://kilobat.app/zh-hant/guides/mac-sleep-stops-downloads.html): Mac 進入睡眠後，大部分 App 的活動都會停止，所以長時間的下載可能中斷或失敗。
- [闔上螢幕時讓 Mac 筆電繼續運作](https://kilobat.app/zh-hant/guides/clamshell-lid-closed-mac.html): 闔上螢幕會讓 Mac 筆電進入睡眠。