WinFsp 文件系统开发完整指南：零内核编程也能在 Windows 上造出虚拟磁盘

【免费下载链接】winfspWindows File System Proxy - FUSE for Windows项目地址: https://gitcode.com/gh_mirrors/wi/winfsp

WinFsp（Windows File System Proxy，也就是常说的 FUSE for Windows）是一个开源文件系统代理框架，它把"在 Windows 上自建文件系统"这件事的门槛，从内核驱动开发直接拉低到普通应用程序开发。你只要会写 C、C++、C#、Python 里的任意一种，就能把云存储、数据库、压缩包甚至一块纯内存变成资源管理器里的真实盘符。下面这份指南，会从原理讲到实战，再带你绕过新手最容易踩的坑。

先讲一个痛点：做文件系统，真的非要啃内核吗

很多人在 Windows 上动过"自己搞个文件系统"的念头：想把网盘挂成本地盘、想把数据库映射成目录、想给老游戏做个虚拟光驱……结果一查资料就懵了——传统方案要求写内核模式驱动程序，要处理 IRP、锁、内存管理、安全上下文，稍不留神就是蓝屏重装。这个学习曲线陡得劝退了绝大多数人，最后只能放弃或者买现成方案。

WinFsp 的出现，本质上就是把这条陡坡铲平了。它替你扛下了所有内核层面的脏活，让你把精力全部放在"这个文件系统该提供什么内容"上。

WinFsp 是什么：一个驱动加一个 DLL 的巧妙分工

用一句话概括：WinFsp 由两半组成，一半住在内核里，一半住在用户态。

内核那半是一个文件系统驱动（FSD），负责把自己注册成 Windows 认可的"文件系统"，处理所有系统级交互，比如挂载盘符、响应文件请求、保证安全。用户态那半是一个 DLL，它给开发者暴露一套干净的 API。当某个程序在资源管理器里双击文件、复制粘贴、读写数据时，Windows 会把请求打包成 I/O 包发给 FSD，FSD 再转发给你写的用户态程序，你的程序处理完把结果原路送回。

你可以把它理解成"翻译官 + 代办员"：系统不认识你的数据，但 WinFsp 认识系统，也认识你。对系统来说它是个正经文件系统，对你来说它只是个普通库。原生 C/C++ API、FUSE 2.8 接口、FUSE 3.2 接口、.NET 封装，四种姿势任你选，而且 Windows 7 到 Windows 11、x86/x64/ARM64 全平台覆盖。

第一次亲密接触：三步挂载一个内存文件系统

空谈原理没意思，先花五分钟跑一个真的。WinFsp 自带的 MEMFS 示例是一个"活在内存里的文件系统"，用它感受一下挂载的整个过程。

第一步，安装 WinFsp，安装界面里记得勾选 Developer 选项，这样会带上头文件、库文件和 MEMFS 示例程序。

第二步，打开命令行，把 MEMFS 挂到 X 盘：

net use X: \\memfs64\test

第三步，往里面写点东西再读出来：

echo "hello world" > X:\hello.txt dir X:\ type X:\hello.txt

看见没？X 盘是真的能存能取，数据其实躺在内存里，重启就没了。用完记得net use X: /delete卸载。这一套命令跑通，你就已经完成了一个文件系统的完整生命周期：挂载、读写、卸载。MEMFS 的源码就在项目的tst/memfs/目录里，随时可以翻出来对照着看。

手把手实战：从空项目到可运行的 passthrough 文件系统

跑通示例之后，下一步是自己动手写一个。官方教程（doc/WinFsp-Tutorial.asciidoc）带着你从零写一个 passthrough——它把 Windows 发来的文件操作原样转发给底层 NTFS，是个绝佳的入门练手项目。

流程分四步走。

第一步，Visual Studio 里新建一个 Win32 控制台应用，选"空项目"。

第二步，配置两个路径：C/C++ 附加包含目录填$(MSBuildProgramFiles32)\WinFsp\inc，链接器附加依赖项填$(MSBuildProgramFiles32)\WinFsp\lib\winfsp-$(PlatformTarget).lib。

第三步，写入口代码。骨架其实短得惊人：一个SvcStart回调负责初始化文件系统，一个SvcStop回调负责收尾，最后调用FspServiceRun把它跑起来。就这么几件事。

第四步，编译运行。成功的话你会看到服务启动、盘符出现，然后就能在资源管理器里像普通磁盘一样操作了。

这里有个细节值得记住：你的文件系统是给整个操作系统提供服务的"系统组件"，所以它应该是个控制台程序，别弹 GUI、别阻塞等待输入。这样它既能直接前台运行，也能注册成 Windows 服务，或者交给 WinFsp 自带的 Launcher 来托管，三种形态随你切换。

把文件系统玩成 IPC：WinFsp 的隐藏身份

很多人没意识到，WinFsp 底层其实是一套进程间通信（IPC）机制，只是它的"接口"恰好长得跟文件操作一模一样。来感受一下一次普通的写入背后发生了什么：你的程序调用WriteFile，请求被打包发给内核里的 FSD，FSD 通过事务机制转发给用户态的文件系统进程，那边处理完再把结果传回来。请求方和实现方根本不认识对方，全靠文件系统这座桥沟通。

更有意思的是，这套 IPC 同步异步都支持。同步模式下，请求方必须等着处理结果返回；异步模式下，请求方可以先撤，处理完成后结果再送回来（项目文档doc/WinFsp-as-an-IPC-Mechanism.asciidoc里有详细的对比时序图）。这意味着你不仅能拿它做文件系统，还能把它当成一种"文件即接口"的通信方式——服务端暴露的每个文件、每个目录，都是可以被另一个进程安全访问的数据通道。设计多进程架构时，这是个非常规但很好用的思路。

实测性能：和 NTFS 同场竞技，结果出乎意料

担心用户态文件系统性能拉胯？WinFsp 用数据说话。项目自带的性能测试（doc/WinFsp-Performance-Testing.asciidoc）把 MEMFS、NTPTFS 和原生 NTFS 放在同一批操作里对比，柱状图越短越快，NTFS 作为基准取值为 1.0。

结果很提气：内存文件系统在 create、open、overwrite 等操作上全面快过 NTFS，比如 create 只花了 NTFS 大约三分之一的时间；读写的场景里，非缓存模式的 page 级读写也明显领先。也就是说，在某些场景下 WinFsp 文件系统不仅能追平 NTFS，甚至能反超。当然，具体表现取决于你文件系统的实现质量，但至少"用户态就注定慢"这个刻板印象，可以丢掉了。

绕开这些坑：新手最容易踩的五个雷区

踩坑是成长的必经之路，但有些坑明明可以绕过去。下面是实战中出镜率最高的五个。

雷区一：Windows 7 提示驱动未签名。多半是系统缺 SHA-2 代码签名支持，把系统更新打全就好。

雷区二：WinFsp 盘里的程序没法以管理员身份运行。Windows 对承载可执行文件的文件系统有"文件名必须是 NTFS"的执念，启动 MEMFS 时加上-F NTFS参数即可解决。

雷区三：断开网络驱动器失败。如果机器上装了 Dokany，它的 Network Provider 会来抢地盘。去系统设置里调整 Network Provider 顺序，让 WinFsp 排在 Dokany 前面。

雷区四：运行时报找不到 DLL。WinFsp 刻意不往系统目录里塞 DLL，这是有意的设计。正确做法是把 WinFsp DLL 标记为延迟加载，再用FspLoad在进程启动时动态装载，教程里有详细说明。

雷区五：想挂载到某个已有目录，结果失败。Windows 的 NTFS 不允许在非空目录上创建挂载点（重解析点），这是平台限制，不是 bug。要么挂载成独立盘符，要么先确保目标目录为空。

生态巡礼：哪些知名项目在用 WinFsp

判断一个框架靠不靠谱，看它的用户名单就够了。WinFsp 的生态相当热闹：sshfs-win让你在 Windows 上直接挂载 SSH 远程目录，rclone把几十种云存储变成盘符，Cryptomator在云端文件上做透明加密，JuiceFS用 Redis 加 S3 拼出分布式 POSIX 文件系统，还有 NFS for Windows、s3fs 等一大批方案，全都跑在 WinFsp 上。

语言绑定同样丰富：Go 有 cgofuse、Python 有 winfspy、Rust 有 winfsp-rs、Java 有 jnr-fuse。换句话说，你熟悉哪种语言，就有对应的轮子可以借力，完整清单在项目文档doc/Known-File-Systems.asciidoc里。

写给最后的你：三条路径与行动建议

看完这篇指南，你可以按自己的目标选一条路出发。

只想赶紧用上现成方案，那就直接装一个基于 WinFsp 的应用，比如 sshfs-win 或 rclone，当天就能把远程存储挂成本地盘。

想认真学会这门手艺，建议按这个顺序来：先读doc/WinFsp-Tutorial.asciidoc走一遍 passthrough，再啃doc/WinFsp-API-winfsp.h.md摸清 API 全貌，然后去tst/目录里翻 memfs、passthrough、ntptfs 这些现成样例，边读边改。遇到疑难杂症，doc/Frequently-Asked-Questions.asciidoc里藏着不少答案。

想深入内核、为社区做贡献，那就把源码拉下来：git clone https://gitcode.com/gh_mirrors/wi/winfsp。核心代码集中在src/dll/（用户态库）和src/sys/（内核驱动）两个目录，头文件在inc/winfsp/下，构建步骤参考doc/WinFsp-Building.asciidoc。

Windows 上自建文件系统这件事，以前是少数内核高手的专利，如今已经是普通开发者的日常工具。从五分钟跑通 MEMFS，到写出自己的第一个 passthrough，你离"亲手造一个盘"只差一次动手。挑个周末，从那条net use命令开始吧。⚡

【免费下载链接】winfspWindows File System Proxy - FUSE for Windows项目地址: https://gitcode.com/gh_mirrors/wi/winfsp