FUSE（Filesystem in Userspace）允许用户态进程实现文件系统，无需内核模块、root权限，调试安全但性能略低；其通过/dev/fuse与内核VFS交互，回调处理open/read等请求。
什么是 FUSE，为什么不用内核模块写文件系统
FUSE（Filesystem in Userspace）让普通用户进程能实现文件系统逻辑，无需编写内核模块、不需 root 权限加载、调试方便。Linux 内核只提供一个通用通道（/dev/fuse），把 VFS 请求（如 open、read、readdir）转发给用户进程；你的程序收到请求后处理，再通过 fuse_reply_* 回复。相比内核模块，FUSE 开发周期短、崩溃不会导致系统死机，但性能略低、不支持某些高级特性（如 DAX、block device 直通）。
安装依赖并验证 FUSE 环境是否可用
先确认系统已启用 FUSE 模块，并装好开发头文件：
sudo apt install fuse3 libfuse3-dev # Ubuntu/Debian sudo modprobe fuse lsmod | grep fuse # 应输出 fuse 行
检查当前用户是否在 fuse 用户组中（否则挂载会报 fuse: failed to open /dev/fuse: Permission denied）：
-
groups命令查看是否含fuse - 若无，执行
sudo usermod -aG fuse $USER，然后重新登录终端 - 运行
fusermount3 -u /mnt/test（如果挂载点残留）和ls -l /dev/fuse（应为 crw-rw-rw-，且属组 fuse）
用 C++ 实现最简 FUSE 文件系统（基于 libfuse3）
libfuse3 的 C++ 使用没有官方封装类，直接调用 C 接口，但可封装成类管理生命周期。关键点是定义 fuse_operations 结构体并填充回调函数指针，每个字段对应一个系统调用（如 getattr 对应 stat()）。
以下是最小可行示例的核心逻辑（省略错误检查，仅保留主干）：
struct MyFS {
static int getattr(const char *path, struct stat *stbuf, struct fuse_file_info *fi) {
memset(stbuf, 0, sizeof(*stbuf));
if (strcmp(path, "/") == 0) {
stbuf->st_mode = S_IFDIR | 0755;
stbuf->st_nlink = 2;
} else if (strcmp(path, "/hello") == 0) {
stbuf->st_mode = S_IFREG | 0444;
stbuf->st_nlink = 1;
stbuf->st_size = 13;
} else {
return -ENOENT;
}
return 0;
}
<pre class="brush:php;toolbar:false;">static int readdir(const char *path, void *buf, fuse_fill_dir_t filler,
off_t offset, struct fuse_file_info *fi, enum fuse_readdir_flags flags) {
if (strcmp(path, "/") != 0) return -ENOTDIR;
filler(buf, ".", nullptr, 0, 0);
filler(buf, "..", nullptr, 0, 0);
filler(buf, "hello", nullptr, 0, 0);
return 0;
}
static int read(const char *path, char *buf, size_t size, off_t offset,
struct fuse_file_info *fi) {
const char *str = "Hello, FUSE!\n";
size_t len = strlen(str);
if (offset >= len) return 0;
size_t to_copy = std::min(size, len - (size_t)offset);
memcpy(buf, str + offset, to_copy);
return to_copy;
}};
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;
struct fuse_operations ops = {};
ops.getattr = MyFS::getattr;
ops.readdir = MyFS::readdir;
ops.read = MyFS::read;
return fuse_main(args.argc, args.argv, &ops, nullptr);}
编译命令：
g++ -std=c++17 hellofs.cpp `pkg-config --cflags --libs fuse3` -o hellofs
挂载运行：
mkdir -p /mnt/hello ./hellofs /mnt/hello -f -s # -f 前台运行，-s 单线程（方便调试）
此时 ls /mnt/hello 应看到 hello，cat /mnt/hello/hello 输出 Hello, FUSE!。
常见崩溃点与调试技巧
FUSE 程序一出错就静默退出或卡住，根本原因是：内核等待回复，而你的回调没调用 fuse_reply_*（libfuse3 C API）或返回负值未被正确处理。C++ 封装时尤其容易漏掉异常捕获。
- 所有回调函数必须返回 0 或负的 errno（如
-ENOENT），**不能抛 C++ 异常**；建议在每个回调入口加try { ... } catch (...) { return -EIO; } -
read/write中注意offset和size边界，避免越界读写；返回值必须是实际字节数，不能多也不能少 - 调试时务必加
-f -s启动，配合gdb ./hellofs单步；也可用strace -e trace=write,read,openat观察用户态行为 - 挂载后不要用
rm -rf强删，先fusermount3 -u /mnt/hello；否则内核可能卡在 D 状态，需重启才能恢复/dev/fuse
真正写生产级 FUSE 文件系统时，元数据缓存、并发访问控制、路径解析一致性、符号链接处理这些细节比接口调用复杂得多——它们不会报编译错误，但会在随机负载下暴露竞态或不一致。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
