macfuse.github.io

macFUSE 是给 macOS 添加 FUSE 文件系统支持的软件包。它的核心工作方式是：拦截 macOS 上的文件系统操作，把这些操作转发给一个运行在用户空间的 FUSE 文件系统进程，由该进程返回数据或执行动作。这个进程可以是应用、后台服务，或任何用户空间进程。理解这一点，就能理解 macFUSE 为什么比传统内核文件系统更容易开发、更安全，也更容易调试。

拦截与转发：macFUSE 的核心机制

传统文件系统运行在内核空间，开发和调试门槛高，出错可能影响整个系统。macFUSE 把文件系统逻辑移到用户空间，内核侧只负责把文件操作交给对应的 FUSE 进程。

一次典型的读取过程可以这样理解：

1. 某个应用对挂载点发起文件读取。
2. macFUSE 拦截该操作，并转发给负责这个文件系统的用户空间进程。
3. 该进程从自己的数据源取回内容——可以是本地存储、网络资源、内存，或几者的组合。
4. 数据沿原路返回给发起读取的应用。

对上层应用来说，它只是在访问一个普通路径；对开发者来说，文件系统逻辑就是一个普通用户空间程序，可以用平时开发 macOS 应用的工具、调试器和库来处理。

开发者可用的 API

macFUSE 提供多套 API，覆盖不同开发习惯：

由于 FUSE API 在 macOS、Linux、Windows（通过第三方实现）上都有，文件系统代码可以跨平台复用，改动很少甚至无需改动。第三方语言绑定或封装还允许用 Python、Java、C#、JavaScript、Go、Rust 等语言开发。

FSKit 后端：不再依赖内核扩展

macFUSE 正在走出对内核扩展的依赖。借助新的 FSKit 后端，受支持的文件系统可以在 macOS 26 上完全运行于用户空间。对安装者来说，这意味着不再需要重启进入恢复模式来启用 macFUSE 内核扩展支持，安装更快，设置过程也更连贯。

需要注意适用条件：这一变化针对“受支持的文件系统”和 macOS 26；其他系统版本或未适配的文件系统，仍需按原有方式处理内核扩展相关设置。

终端用户与开发者分别得到什么

• 终端用户：安装 macFUSE 软件包后，就能使用第三方 FUSE 文件系统。但 FUSE 文件系统本身需要单独安装，macFUSE 只提供运行支持。
• 开发者：使用上述 API 构建文件系统，内容来源不受限制；相比内核文件系统，开发更快、运行更安全，调试手段也与普通应用一致。

常见卡点

• 以为装了 macFUSE 就有可用文件系统——实际上具体文件系统要另行安装。
• 在 macOS 26 上仍按旧流程寻找内核扩展启用步骤——受支持的文件系统已可通过 FSKit 后端在用户空间运行。
• 跨平台复用代码时忽略 macOS 特有扩展——libfuse 的 macOS 扩展是可选的，按需启用即可。

macFUSE 是 macOS 上的一个软件包，用来让 macOS 支持 FUSE 文件系统。FUSE 文件系统运行在用户空间，因此比传统内核文件系统更容易开发、运行更安全、也更灵活。它面向两类人：普通用户安装后可以使用第三方 FUSE 文件系统，但文件系统本身需要另行安装；开发者则可以用它提供的 API 构建自己的文件系统，内容可以来自本地存储、网络资源、内存或它们的组合。

macFUSE 解决什么问题

macOS 原生并不直接支持 FUSE 文件系统。macFUSE 的作用是拦截文件系统操作，把它们转发给一个运行在用户空间的 FUSE 文件系统进程，由该进程返回数据或执行动作。这个进程可以是应用、后台服务，或任何用户空间进程。

对开发者来说，关键收益是：文件系统代码运行在用户空间，可以沿用开发普通 macOS 应用时的编程工具、调试器和库，不必编写内核文件系统。同时 FUSE API 在 macOS、Linux、Windows（通过第三方实现）上都有，文件系统可以跨平台复用，改动很少甚至不用改。

安装后能得到什么

作为终端用户，安装 macFUSE 包本身只是获得运行第三方 FUSE 文件系统的能力，具体文件系统要单独安装。网站提供了 Demo File Systems 和 Stable Releases 入口，可用于了解可用的示例和稳定版本。

作为开发者，macFUSE 提供多套 API：

• libfuse2 和 libfuse3：Linux FUSE 接口的参考实现，让大量现有 FUSE 文件系统可以直接在 macOS 上使用；libfuse 还包含支持 macOS 特有功能的可选扩展。
• macFUSE.framework：面向对象的文件系统 API，用于开发 macOS 文件系统。

此外还有第三方语言绑定或封装，可用 Python、Java、C#、JavaScript、Go、Rust 等语言开发文件系统。

一个值得注意的变化：FSKit 后端

macFUSE 正在从内核扩展方式演进。借助新的 FSKit 后端，受支持的文件系统可以在 macOS 26 上完全运行在用户空间，不再需要重启进入恢复模式来启用 macFUSE 内核扩展支持，安装更快，设置过程也更顺畅。如果你的系统是 macOS 26 且使用受支持的文件系统，这是选择新版本的主要理由；其他情况仍按发布说明选择稳定版本。

去哪里找资源和反馈

项目托管在 GitHub，网站首页提供了 Releases（发布版本）、Issues（问题反馈）、Wiki（文档）和 Google Group（讨论组）入口，另有 Sponsor 入口用于赞助项目。遇到安装或使用问题，Issues 和 Wiki 是优先查看的地方；需要交流经验可以加入 Google Group。

安装 macFUSE 后，你获得的是“运行第三方 FUSE 文件系统”的能力，而不是某个现成的文件系统。macFUSE 本身不提供网盘、压缩包或远程目录的访问功能，这些需要你另外安装对应的 FUSE 文件系统软件。装好 macFUSE 再装一个具体的 FUSE 文件系统，才能在 Finder 里看到并使用它。

macFUSE 在系统里扮演什么角色

macFUSE 是一个给 macOS 增加 FUSE 文件系统支持的软件包。它拦截文件系统操作，转发给运行在用户空间的 FUSE 文件系统进程，由该进程返回数据或执行动作。这个进程可以是普通应用、后台服务，或任何用户空间进程。

对普通用户来说，这意味着：只要某个第三方工具基于 FUSE 开发，装上 macFUSE 后它就能在 macOS 上挂载成可浏览的磁盘或目录。

安装后你实际能做的事

• 使用第三方 FUSE 文件系统：这是普通用户最直接的用途。前提是该文件系统已单独安装。
• 访问来源任意的文件内容：FUSE 文件系统的内容可以来自本地存储、网络资源、内存，或它们的组合。具体能访问什么，取决于你安装的那个文件系统。
• 在 Finder 中像普通磁盘一样操作：挂载后按该文件系统提供的能力读写，体验接近本地目录。

需要注意：macFUSE 官网列有 Demo File Systems 和 Stable Releases，前者是示例性质的，后者是 macFUSE 自身的稳定版本，都不是“装完就能用的网盘工具”。

新版在安装体验上的变化

macFUSE 正在从内核扩展方案演进。借助新的 FSKit 后端，受支持的文件系统可以在 macOS 26 上完全运行于用户空间。对普通用户的实际影响是：

这条变化有前提：仅适用于“受支持的文件系统”和 macOS 26。你使用的具体 FUSE 文件系统是否已支持 FSKit，需要看该软件自己的说明。

判断自己是否该装

适合装的情况：你明确要用的某个工具或服务要求先安装 macFUSE，且它提供的是 FUSE 文件系统。

不必装的情况：你只是想要一个网盘客户端或文件同步工具，而它并不依赖 FUSE——那装 macFUSE 不会带来任何可见功能。

安装前先确认两件事：目标文件系统是否支持你的 macOS 版本；在 macOS 26 上它是否已走 FSKit 后端，从而免去恢复模式步骤。装完 macFUSE 后如果 Finder 里什么都没多出来，属于正常现象，接着安装你要用的那个 FUSE 文件系统即可。

选择 macFUSE 开发文件系统的核心理由是：文件系统运行在用户空间，你可以用开发普通 macOS 应用的工具、调试器和库来构建它，同时借助跨平台的 FUSE API 把同一套文件系统移植到 Linux、Windows 等系统。适用前提是目标系统为 macOS，且你愿意通过 macFUSE 提供的 API（libfuse2、libfuse3 或 macFUSE.framework）来实现文件系统逻辑；在 macOS 26 上，受支持的 FSKit 后端文件系统可完全运行在用户空间。

用户空间开发带来什么实际好处

macFUSE 会拦截文件系统操作，并转发给一个运行在用户空间的 FUSE 文件系统进程，这个进程可以是应用、后台服务或任何用户空间进程。由此带来的开发体验差异是：

• 工具链不变：可以使用与标准 macOS 应用相同的编程工具、调试器和库，不需要进入内核开发环境。
• 开发更快、运行更安全：相比内核内文件系统，用户空间实现更易开发、更快迭代，出错时影响范围也更可控。
• 内容来源灵活：文件系统数据可以来自本地存储、网络资源、内存，或这些来源的组合。

例如需要做一个把远程仓库挂载成本地目录的文件系统时，网络请求、缓存和协议解析都可以放在用户空间进程里完成，调试方式与普通应用一致。

跨平台复用与语言选择

FUSE API 已存在于多个操作系统，包括 macOS、Linux 和 Windows（通过第三方实现）。这意味着用 FUSE 构建的文件系统可以以很小甚至零修改复用到其他平台，保持一致的体验和共享代码库。

语言方面，除 C 等直接使用 API 的方式外，还可以通过第三方语言绑定或封装使用 Python、Java、C#、JavaScript、Go、Rust 等语言开发文件系统。选择哪种语言主要取决于团队熟悉度和生态，而不是 macFUSE 本身的限制。

可用的 API 与兼容性

macFUSE 提供多个 API：

如果你的目标是复用已有的 Linux FUSE 文件系统，libfuse2/libfuse3 通常是更直接的路径；如果是新开发且希望采用面向对象接口，可以评估 macFUSE.framework。

安装形态的变化对开发者的影响

macFUSE 正在从内核扩展方式演进。借助新的 FSKit 后端，受支持的文件系统在 macOS 26 上可以完全运行在用户空间，不再需要重启进入恢复模式来启用内核扩展支持，安装更快、设置更顺畅。对开发者而言，这意味着在新系统上分发和启用文件系统的流程更简单；但需注意“受支持的文件系统”这一限定，具体支持范围应以项目文档为准。

另外，作为终端用户安装 macFUSE 包只是获得使用第三方 FUSE 文件系统的能力，FUSE 文件系统本身需要单独安装——这一点在开发和分发时同样成立：你的文件系统需要作为独立组件提供给使用者。

macFUSE 的稳定版本、源码、问题反馈和社区讨论入口都集中在项目官网 macfuse.github.io 上。页面顶部直接列出 GitHub、Releases、Issues、Wiki、Google Group 和 Sponsor 六个入口，其中 Releases 是获取稳定版本的位置，GitHub 是源码与项目主页，Issues 用于报告问题，Wiki 用于查阅文档，Google Group 用于参与讨论。这些入口面向所有访客公开，但下载和参与讨论是否需要 GitHub 或 Google 账号，页面未说明。

官网提供的资源入口

macFUSE 官网首页的导航区把项目资源集中在一处，按用途可以这样对应：

页面正文中另有 “Stable Releases” 区域，与导航中的 Releases 指向同一类内容，即经过验证的稳定版本，而不是开发中的构建。需要安装包时优先从这里进入，不必在站外搜索第三方转载的版本。

按身份选择入口

普通用户：只需要 Releases 里的稳定版本安装包。官网说明，安装 macFUSE 软件包后即可使用第三方 FUSE 文件系统，但 FUSE 文件系统本身需要单独安装，macFUSE 不附带具体的文件系统。因此装完 macFUSE 后如果看不到新的磁盘或目录，先确认对应的 FUSE 文件系统是否已经安装。

开发者：从 GitHub 进入源码仓库，配合 Wiki 查阅文档，用 Issues 反馈问题。官网说明 macFUSE 提供 libfuse2、libfuse3 以及面向对象的 macFUSE.framework 等 API，文件系统内容可以来自本地存储、网络资源、内存或它们的组合。

遇到问题或想交流：Issues 适合记录可复现的问题，Google Group 适合开放式讨论和提问。两者分工不同，把使用疑问发到 Issues 通常不如发到讨论组合适。

安装前需要知道的一个变化

官网提到，借助新的 FSKit 后端，受支持的文件系统在 macOS 26 上可以完全运行在用户空间，不再需要重启进入恢复模式来启用 macFUSE 内核扩展，安装更快、设置更顺畅。这意味着在新系统上安装的体验与旧版本不同；如果你参考的是较早的教程，其中“重启进恢复模式”的步骤可能已经不适用。具体哪些文件系统受支持，以 Releases 和 Wiki 中的说明为准。

常见卡点

• 装完 macFUSE 却没有新文件系统：macFUSE 只是支持层，具体文件系统要另外安装。
• 在站外下载安装包：稳定版本以官网 Releases 为准，避免来源不明的构建。
• 把问题发错地方：可复现的缺陷走 Issues，使用疑问走 Google Group。
• 照搬旧教程：macOS 26 上的安装流程已因 FSKit 后端而变化，以官网当前说明为准。