FUSE是内核级VFS接口，必须通过bazil.org/fuse与/dev/fuse通信才能真正挂载；挂载前须确认已安装FUSE模块和工具、挂载目录为空、权限足够，否则mount失败或行为异常。
不能直接用 net/http 或 os/fs 挂载分布式文件系统——FUSE 是内核级 VFS 接口，必须通过 bazil.org/fuse（或其维护分支 github.com/bazil/fuse）与 /dev/fuse 通信，否则挂载点只是普通目录，ls 看不到行为、mount | grep fuse 找不到条目。
挂载前必须确认的三件事
很多人跑不起来，不是代码问题，而是环境卡死在这三步：
- 系统已安装 FUSE 内核模块和用户态工具：
sudo apt-get install fuse（Debian/Ubuntu），brew install macfuse（macOS），FreeBSD 需启用fusefs模块 - 挂载目录必须为空：
/mnt/mydfs不能有残留文件，否则fuse.Mount()直接返回syscall.EBUSY - 权限足够：要么以 root 运行，要么在
/etc/fuse.conf中取消注释user_allow_other并加-o allow_other选项，否则非 root 用户无法访问挂载点
为什么不能复用 http.FileServer 或 embed.FS 的逻辑
FUSE 不是 HTTP 服务，也不是内存虚拟文件树。它要求你实现的是内核能理解的 inode 操作语义：
-
Lookup()对应open()和路径解析，不是简单 map 查 key -
Attr()必须返回真实Size、Mode、Mtime，否则ls -l显示异常或stat失败 -
ReadDir()返回的DirEntry名字必须不含路径前缀，且不能漏掉.和..（除非显式禁用） - 所有 handler 函数必须 recover panic：一个未捕获的 panic 会让整个 FUSE 连接断开，表现为
Transport endpoint is not connected
分布式后端接入的关键约束
你的“分布式”逻辑（比如对接 S3、etcd、Raft 存储）必须适配 FUSE 的同步阻塞模型：
立即学习“go语言免费学习笔记（深入）”；
- 不要在
Read()里做长耗时 RPC 调用——会卡住整个 VFS 请求队列；建议预加载元数据 + 异步 prefetch 数据块 -
Write()必须支持原子性语义：FUSE 可能分多次调用Write()写入同一文件，需靠Node实例维护临时 buffer 或 session ID 关联写入上下文 - 避免在
Root()初始化全量索引——挂载时只建根节点，Lookup()按需拉取子项，否则启动慢且内存爆炸 - 若依赖网络存储，
Attr()中的Atime/Ctime建议设为 0 或固定时间戳，避免因 NTP 漂移导致客户端缓存误判
调试时最该看的两个地方
挂载后行为异常？别急着改业务逻辑，先盯住这两处：
- 运行时加
-debug选项：fuse.Mount(mountPoint, fuse.Debug)，日志会输出每条 VFS 请求（LOOKUP、READDIR、OPEN）及返回码，一眼看出哪步没响应 - 检查
fusermount -u /mnt/mydfs是否成功：失败说明进程还在持有句柄（比如 goroutine 泄漏、defer 没触发 Close），此时强制 umount 会留下Transport endpoint is not connected
真正难的不是实现接口，而是让每个 handler 在 panic、网络超时、并发竞争下都保持内核可见的稳定性——FUSE 没有重试机制，一次失败就暴露给用户进程。
