# 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 应用。
- 其 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 指示你进入“系统偏好设置”→“桌面与程序坞”，并找到“调度中心”部分。在当前的 macOS 中，请打开“系统设置”→“桌面与程序坞”，然后向下滚动到“调度中心”。关闭**根据最近使用情况自动重新排列空间**，并开启**显示器具有单独的空间**。具体文字和位置可能因 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 循环切换宽度。它还展示了浮动、空间和窗口大小调整的快捷键。如果某个快捷键与其他应用冲突，请编辑 Lua 表，重新加载配置；如果插件停止响应，请检查 Hammerspoon 控制台。

Spoon 自身的配置可以筛选应用，并调整窗口比例。README 将 `window_filter` 和 `window_ratios` 列为配置项。只更改文档中能找到说明的设置，然后测试一个普通应用窗口，以及一个你希望排除的应用。维护者还指出，macOS 限制把窗口完全移到屏幕外，因此位于边缘的平铺窗口可能仍会部分可见。

这是一套基于 Lua 的工具链。它适合那些能够阅读配置文件、并希望利用 Hammerspoon 灵活性的人。如果你更喜欢独立应用和设置窗口，这种设置可能会让你觉得维护起来很费力。PaperWM.spoon 的权威说明是它的 README；开源项目可能会有变化，因此请在按照说明操作之前查看仓库。

PaperWM.spoon 的 README 称它“受 PaperWM 启发”，并链接到 [PaperWM 项目](https://github.com/paperwm/PaperWM)，查阅日期为 2026 年 11 月 12 日。两个项目各自拥有独立的实现和设置说明。

我们开发了 SlidePane，这是一款 macOS 应用，适合希望在无需维护 Lua 脚本的情况下配置窗口布局的人。如果你更喜欢应用内设置和内置快捷键控制，它可能适合你；如果你想使用 PaperWM.spoon 所基于的 Hammerspoon 脚本模型，PaperWM.spoon 则更合适。应用的设置步骤请参阅[安装 SlidePane 并开始免费试用](/zh-Hans/guides/installation)。

## 相关页面

[Mac 上的 Niri：分步复现相同的工作流](/zh-Hans/blog/niri-on-mac)比较了另一种滚动工作流。[快捷键和键盘布局](/zh-Hans/guides/shortcuts)介绍了如何检查应用中的快捷键绑定。
