macOS FUSE软件使用手册

macOS FUSE软件使用手册

本手册旨在指导用户安装和使用由gromgit维护的macOS FUSE相关软件。这些软件在Homebrew核心库中不再更新，但通过此tap持续提供支持。

安装指南

系统要求

请注意，自2021年10月25日起，Homebrew已停止对macOS Mojave的支持。该项目虽暂时继续为FUSE公式提供Mojave版本的二进制文件，但不保证对外部依赖进行相同支持。因此，在2022年某个时间点后，Mojave的支持将会被逐步取消。

安装步骤

对于新用户:

如果您是首次安装这些FUSE相关的软件，可以直接执行以下命令来安装特定软件（以SSHFS为例）：

brew install gromgit/fuse/sshfs-mac

曾经从Homebrew核心库安装过的用户:

如果您之前已经安装了Homebrew核心库中的FUSE相关软件，但在想要切换到gromgit提供的版本前，需先卸载旧版本：

brew uninstall sshfs
brew install gromgit/fuse/sshfs-mac

请注意，所有从gromgit的tap安装的软件都会在名称末尾加上-mac以避免与Homebrew核心库中的软件冲突。

项目使用说明

一旦安装完成，您可以通过查看每个工具自带的帮助文档了解具体用法。例如，对于SSHFS，可以使用：

sshfs-mac --help

项目API使用文档

本项目主要涉及的是利用Homebrew的Tap机制管理macOS FUSE软件，并非直接提供API给开发者。但是，如果您的应用需要与这些FUSE驱动的文件系统交互，您应查阅各个软件自身的文档来学习如何正确调用它们提供的功能或接口。

解决常见问题

• 为何某些软件版本较老？ 可能是因为它们仅兼容libfuse v2而macFUSE尚未升级至v3，或者原作者已停止维护。
• 遇到“需要从源码构建”提示怎么办？ 若因M1芯片或非常规Homebrew安装路径导致，可能需要手动编译或设置Rosetta环境安装。
• 如何处理命名冲突？ 使用带-mac后缀的软件名即可规避与Homebrew核心库的冲突。

通过上述指南，您应该能够顺利地安装并开始使用gromgit的macOS FUSE相关软件。如遇具体问题，不妨直接在项目GitHub仓库提交issue寻求帮助。