FUSE是用户空间文件系统框架，允许普通用户进程实现文件系统逻辑而无需root权限编译内核模块；它通过/dev/fuse与内核通信，将VFS请求转发至用户态程序，兼顾开发效率与系统安全，但存在性能开销和部分内核特性缺失。
什么是 FUSE，为什么不用内核模块
FUSE（Filesystem in Userspace）让普通用户进程能实现文件系统逻辑，无需 root 权限编译加载内核模块。它通过 /dev/fuse 与内核通信，内核把 VFS 层的请求（如 open、read、readdir）转发给你的用户态程序。关键好处是开发调试快、崩溃不蓝屏、可直接用 C++ STL 和现代工具链——但代价是性能略低、不支持某些内核原生特性（如 dax、部分 ACL 细节）。
初始化和挂载入口怎么写（C++17 + libfuse3）
libfuse3 是当前推荐版本，C++ 项目需链接 -lfuse3，头文件为 <fuse3></fuse3>。核心不是继承类，而是填一个 struct fuse_operations 表，每个字段指向你实现的回调函数。挂载入口通常长这样：
int main(int argc, char *argv[]) {
struct fuse_args args = FUSE_ARGS_INIT(argc, argv);
struct fuse_cmdline_opts opts;
if (fuse_parse_cmdline(&args, &opts) != 0) return 1;
<pre class='brush:php;toolbar:false;'>auto *fs = new MyVirtualFS(); // 你的状态对象
struct fuse_operations ops = {};
ops.init = [](fuse_conn_info *conn) -> void* { /* 可设 conn->max_write */ };
ops.getattr = [](const char *path, struct stat *stbuf, struct fuse_file_info *fi) -> int {
return fs->getattr(path, stbuf);
};
ops.readdir = [](const char *path, void *buf, fuse_fill_dir_t filler,
off_t offset, struct fuse_file_info *fi) -> int {
return fs->readdir(path, buf, filler, offset);
};
// ……其他必须/可选操作
return fuse_main(args.argc, args.argv, &ops, fs);}
注意：fuse_main 会接管 argv[0] 并解析 -f（前台运行）、-s（单线程）、-d（debug 日志）等参数；不要自己重复解析；init 回调里可调整传输限制，比如设 conn->max_write = 128 * 1024 避免小包频繁拷贝。
立即学习“C++免费学习笔记（深入）”；
getattr 和 readdir 实现最容易出错的地方
getattr 必须对所有路径返回有效 stat，哪怕只是模拟：根目录 "/" 的 st_mode 得带 S_IFDIR，普通文件得带 S_IFREG，否则 ls 直接报 Transport endpoint is not connected；st_ino 建议用简单哈希或递增 ID，避免冲突；st_nlink 对目录至少为 2（. 和 ..），文件一般为 1。
readdir 不是返回字符串数组，而是调用 filler(buf, name, nullptr, 0) 逐个注入条目，且必须包含 "." 和 ".."（除非你明确想禁用）；filler 第四个参数是偏移量，用于分批，但多数简单 FS 直接传 0 即可；漏掉 "." 会导致 cd . 失败，ls -a 看不见点文件。
-
getattr返回 -ENOENT 表示路径不存在，返回 -EACCES 表示权限拒绝——别混用 - 所有路径参数（
path）都是绝对路径，以"/"开头，不含挂载点前缀 - 多线程下
readdir可能并发调用，确保你的目录遍历逻辑是线程安全的（例如用局部容器，而非共享静态 list）
调试时 fusermount -u 失败或进程僵死怎么办
最常见原因是挂载后程序异常退出但没清理资源，导致内核仍认为该挂载点活跃。此时 fusermount -u /mnt/myfs 会卡住或报 device busy。解决方法：
- 加
-f -s启动 fuse 程序，强制前台单线程，方便 gdb attach 或看 stderr - 在信号处理中调用
unmount：注册SIGINT/SIGTERM，然后调用umount2(mountpoint, MNT_FORCE)（需<sys></sys>） - 检查是否有残留 fd：用
lsof +D /mnt/myfs查谁还打开着该路径下的文件 - 终极手段：
sudo umount -f /mnt/myfs强制卸载（可能丢数据，仅调试用）
另外，libfuse3 默认启用 writeback cache，若你的 write 回调没正确更新 st_mtime 或缓存逻辑有 bug，会导致 cat 看到旧内容——临时关掉它：在 init 里设 conn->cache_timeout = 0; conn->entry_timeout = 0;。
