Zig文件系统示例在Windows上失效：deleteTree触发EBUSY错误

问题原因 #

• WSL2文件系统交互限制：WSL2与Windows主机挂载目录（如/mnt/下的目录）交互时，可能出现目录被隐性占用的情况——比如Windows侧进程（如资源管理器）或Git Bash本身持有该目录的文件句柄，导致Linux内核返回EBUSY错误。此时Zig的deleteTree能删除目录内容，但无法移除空目录。
• Zig开发版本的边缘场景疏漏：你使用的是Zig 0.11.0-dev开发版本，该版本的deleteTree实现可能在WSL2环境下对EBUSY错误的处理存在不足，这类问题通常会在正式版本中修复。

解决方案 #

• 添加针对性错误处理：替换catch unreachable，对EBUSY错误单独处理，手动删除空目录：

  const std = @import("std");
  
  pub fn main() !void {
      _ = std.fs.cwd().deleteTree("test-tmp") catch |err| switch (err) {
          error.FileBusy => {
              // 目录内容已被删除，尝试单独移除空目录
              try std.fs.cwd().deleteDir("test-tmp");
          },
          else => return err,
      };
  }
  

• 切换到Zig稳定版本：升级到Zig 0.10.x系列稳定版，或等待0.11正式版发布，开发版本的兼容性问题通常会在正式发布前解决。
• 使用WSL2原生文件系统：将测试目录放在WSL2原生文件系统中（如/home/你的用户名/下），而非Windows挂载的/mnt/目录，减少跨文件系统的兼容性冲突。
• 排查目录占用：确保Git Bash的当前工作目录不在test-tmp或其子目录中，同时关闭Windows侧可能访问该目录的进程（如资源管理器、编辑器）。

是否为教程示例过时？ #

并非示例过时。教程其他示例正常运行说明基础逻辑没问题，该问题是WSL2特定环境与Zig开发版本的兼容性边缘场景，不属于示例本身的设计缺陷。

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