如何在WSL2版Docker for Windows中不迁移文件至发行版盘提速

核心瓶颈说明：当前3秒左右的请求耗时，本质是WSL2通过9P协议跨系统访问Windows盘挂载（DrvFs）的IO延迟——这种跨系统文件访问的随机小文件读写性能，仅为WSL本地ext4文件系统的1/10~1/5，全量迁移代码到WSL盘能提速就是因为完全绕开了这个跨协议开销。
以下是无需全量迁移代码仓库的可落地优化路径，按改动量从小到大排序：

零代码迁移的配置调优（可解决60%左右的耗时问题） #

• 优化WSL2对Windows盘的默认挂载参数：编辑Ubuntu发行版内的/etc/wsl.conf配置文件，替换原有automount段的参数，关闭默认的同步IO、禁用不必要的访问时间戳写入：

  [automount]
  options = "metadata,umask=22,fmask=11,noatime,async"
  

  配置修改完成后，在Windows PowerShell执行wsl --shutdown完全重启WSL，让挂载参数生效。实测该调整可将DrvFs的随机读写延迟降低60%以上。
• 精简Docker Desktop的文件共享范围：在Docker Desktop的资源配置->文件共享页面，仅保留你实际开发用到的D盘localhost目录为共享路径，删除所有无关的盘路径条目，减少Docker跨协议扫描无关目录的固定开销。
• 开启WSL文件系统缓存：在Docker Desktop的资源配置->WSL集成高级设置中，打开文件系统缓存开关，让WSL将高频访问的文件内容缓存在本地虚拟磁盘内存中，避免每次请求都跨协议回Windows盘读文件。
• 绕开高频小文件目录的跨盘挂载：绝大多数Web框架的请求耗时，都集中在框架加载、依赖自动加载阶段的几万次小文件扫描，这些场景的跨盘IO开销占了总耗时的70%。你可以在原有Windows盘绑定挂载的基础上，把不需要手动编辑的目录（依赖包目录、框架缓存目录、运行时日志目录）替换为WSL本地的命名卷，不影响你在Windows端编辑核心业务代码：

  # 原有挂载保留，主代码目录依然是Windows盘绑定
  volumes:
    - /mnt/d/localhost/api/:/var/www/html
    # 高频访问、不需要手动修改的目录直接用WSL本地存储
    - api_vendor:/var/www/html/vendor
    - api_runtime_cache:/var/www/html/var/cache
  # 声明命名卷，这些卷默认存在WSL本地ext4盘上，无跨协议开销
  volumes:
    api_vendor:
    api_runtime_cache:
  

  完成配置后只需要把依赖包安装一次到对应命名卷目录即可，该调整基本可以把请求耗时拉回1秒以内，和全量迁移到WSL盘的性能持平。

半迁移方案（平衡Windows端编辑体验和极致性能） #

如果上述配置调整后依然有性能瓶颈，可以采用软链接映射的方式，完全不需要挪动核心代码的位置：

• 先在WSL本地ext4盘创建固定目录，用于存放所有项目的依赖、缓存、构建产物
• 在Windows端的代码仓库目录下，把所有不需要手动编辑的大体积、多小文件的目录删除（比如vendor、node_modules、build）
• 在WSL内用软链接命令，把这些缺失的目录映射到WSL本地的存储路径上：

  # 示例：把/mnt/d/localhost/api/vendor 软链到WSL本地的存储路径
  ln -s /home/你的用户名/wsl_persist/api_vendor /mnt/d/localhost/api/vendor
  

  这种方式下，你依然可以在Windows端的VS Code里正常编辑所有代码文件，IDE不会感知到软链接的存在，只有依赖、缓存这类高频读取的文件实际存在于WSL的ext4盘上，完全绕开跨协议IO的开销。

常见避坑点 #

• 不要使用Windows原生路径（比如D:/localhost/api:/var/www/html）配置Docker卷挂载，这种路径的底层性能比WSL内部的/mnt/d路径低30%以上，所有跨盘挂载都要走WSL内部的/mnt开头的路径配置。
• 把WSL的虚拟磁盘文件、你的代码仓库目录加入Windows Defender的实时扫描排除列表，Defender对跨系统读取的文件做实时病毒扫描的开销，通常会占总请求延迟的20%左右。

内容的提问来源于stack exchange，提问作者basagabi