# macOS 上的 PaperWM.spoon：安裝並設定基本功能

Last updated: 2026-11-12

PaperWM.spoon 是 macOS 上 Hammerspoon 的免費可捲動平鋪視窗管理外掛。設定方式是：先安裝 Hammerspoon，把 PaperWM.spoon 儲存庫複製到 Hammerspoon 的 Spoons 目錄，從 init.lua 載入並啟動這個 Spoon，然後授予 macOS 要求的權限。以下指令依照專案的 README 撰寫，查閱日期為 2026 年 11 月 12 日。

## 重點整理

- PaperWM.spoon 是 Hammerspoon 的 Spoon，不是獨立的 Mac App。
- 它的 README 提供複製指令與 Lua 配置範例。
- README 要求你調整兩項指揮中心設定：停用自動依最近使用情況重新排列空間，並啟用顯示器各自的空間。
- 如果你想要可配置、以 Lua 為基礎的設定，它很適合；如果你不想維護 Hammerspoon 配置，可以考慮其他工具。

## 先安裝 Hammerspoon

請從它的[官方網站](https://www.hammerspoon.org/)取得 Hammerspoon，查閱日期為 2026 年 11 月 12 日。先打開一次，並依照 macOS 的權限提示操作。Hammerspoon 會執行自動化腳本，因此在載入任何程式碼之前，請先確認你安裝的內容。PaperWM.spoon 專案的 README 說明了這個外掛與它的設定方式。我們並未在每一個 macOS 版本上測試這些步驟。

PaperWM.spoon 的[官方 README](https://github.com/mogenson/PaperWM.spoon)，查閱日期為 2026 年 11 月 12 日，提供以下安裝指令：

```bash
git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon
```

請在「終端機」中執行。它會把儲存庫複製到 Hammerspoon 使用的 Spoons 資料夾。如果你使用自訂的 Hammerspoon 配置目錄，請把目的地調整為相符的位置。

## 設定指揮中心選項

README 會指示你前往「系統偏好設定」→「桌面與 Dock」，並找到指揮中心的部分。在目前的 macOS 上，請打開「系統設定」→「桌面與 Dock」，然後捲動到指揮中心。關閉**自動依最近使用情況重新排列空間**，並開啟**顯示器具有個別的空間**。確切的文字與位置可能因 macOS 版本而不同。README 把這些選項列為設定的一部分。

這些是影響 macOS 如何處理空間的系統層級選擇。在更改之前，請先判斷它們是否符合你的設定。如果你使用多台顯示器，請確認它們的空間行為是否符合你的需求。

## 載入並啟動 Spoon

打開 Hammerspoon 的配置檔 `~/.hammerspoon/init.lua`，加入以下 Lua 程式碼：

```lua
PaperWM = hs.loadSpoon("PaperWM")
PaperWM:bindHotkeys(PaperWM.default_hotkeys)
PaperWM:start()
```

儲存檔案。從 Hammerspoon 的選單列圖示中選擇**重新載入設定**。第一行會載入 Spoon，第二行會註冊它文件中記載的預設快速鍵，第三行則開始管理視窗。專案 README 也展示了 SpoonInstall 的做法，以及自訂快速鍵的範例。在編輯按鍵之前，先使用它的預設值，以便判斷設定是否已成功載入。

若要停止 PaperWM.spoon，可以透過 Hammerspoon 的主控台或配置檔呼叫 `PaperWM:stop()`。如果啟動時回報找不到 Spoon，請確認複製的資料夾名稱是 `PaperWM.spoon`，並且位於 Hammerspoon 使用的 Spoons 目錄中。在同時更改多項設定之前，請先檢查 Hammerspoon 主控台是否有 Lua 錯誤。

## 檢查快速鍵，並只做一項變更

PaperWM.spoon 的[README](https://github.com/mogenson/PaperWM.spoon)，查閱日期為 2026 年 11 月 12 日，記載了以下預設值：Option–Command 加方向鍵用來聚焦，Option–Command–Shift 加方向鍵用來交換位置，Option–Command–R 用來循環切換寬度。它也列出浮動、空間與視窗大小調整的快速鍵。如果某個快速鍵與其他 App 衝突，請編輯 Lua 表格、重新載入配置；若外掛停止回應，請查看 Hammerspoon 主控台。

Spoon 本身的配置可以篩選 App，並調整視窗比例。README 把 `window_filter` 與 `window_ratios` 列為可設定的項目。只改動文件中可以明確找到的設定，然後測試一般的 App 視窗，以及一個你想排除的 App。維護者也說明，macOS 會限制把視窗完全移出螢幕，因此位於邊緣的平鋪視窗仍可能部分可見。

這是以 Lua 為基礎的工具鏈。它適合願意閱讀配置檔、並想使用 Hammerspoon 彈性的人。偏好獨立 App 與設定視窗的人，可能會覺得這種設定需要花較多心力維護。PaperWM.spoon 的權威說明是它的 README；由於開放原始碼專案可能會變動，請在依循前先查看儲存庫。

PaperWM.spoon 的 README 寫著它「受 PaperWM 啟發」，並連結到 [PaperWM 專案](https://github.com/paperwm/PaperWM)，查閱日期為 2026 年 11 月 12 日。這兩個專案各自有獨立的實作與設定說明。

我們開發了 SlidePane，這是一款 macOS App，適合想在不維護 Lua 腳本的情況下設定視窗配置的人。如果你偏好 App 設定與內建的快速鍵控制項，它可能適合你；如果你想使用 Hammerspoon 的腳本模型，PaperWM.spoon 則更合適。App 的安裝方式請參閱[安裝 SlidePane，開始免費試用](/zh-Hant/guides/installation)。

## 相關頁面

[Mac 上的 Niri：一步步取得相同的工作流程](/zh-Hant/blog/niri-on-mac)比較了另一種可捲動工作流程。[快速鍵與鍵盤配置](/zh-Hant/guides/shortcuts)則說明如何檢查 App 的快速鍵設定。
