Mac系统下带后缀目录被识别为文件的File System Access API使用问题

问题根源 #

这个问题是macOS系统的默认特性导致的：对于带自定义扩展名的目录，macOS会将部分扩展名的目录识别为应用包/普通文件，Chrome的File System Access API调用系统级文件选择器时会遵循该判定规则，因此调用getDirectoryHandle时这类目录会被过滤无法选中。

可行解决方案 #

• 方案1：绕开子目录选择，直接遍历上层目录获取句柄（最推荐，对外分发也可用）
  如果你可以让用户先选择目标目录所在的上层文件夹，直接通过遍历上层目录条目获取目标目录的句柄，完全绕开系统选择器的判定问题，示例代码如下：

// 先让用户选择thisisfolder.xyz的父级目录
const parentDirHandle = await window.showDirectoryPicker();
let targetDirHandle = null;

// 遍历父目录所有条目匹配目标目录
for await (const [name, entry] of parentDirHandle.entries()) {
  if (name === 'thisisfolder.xyz' && entry.kind === 'directory') {
    targetDirHandle = entry;
    break;
  }
}

if (targetDirHandle) {
  // 可正常读取目标目录内的所有文件
  for await (const [name, entry] of targetDirHandle.entries()) {
    // 你的业务逻辑
  }
}

该方案不需要用户修改系统配置，也不需要调整目录命名，兼容所有平台。

• 方案2：调整目录选择器配置，声明可接受的目录扩展名
  调用系统目录选择器时，通过types参数将你的目录后缀声明为可接受类型，让系统选择器识别该后缀的条目为可选目录，示例代码如下：

const dirHandle = await window.showDirectoryPicker({
  types: [
    {
      description: 'XYZ数据目录',
      accept: {
        'application/octet-stream': ['.xyz']
      }
    }
  ],
  excludeAcceptAllOption: false
});

• 方案3：修改macOS系统的文件识别规则（仅适合内部使用场景）
  如果是内部使用的脚本，可以引导用户手动修改系统识别规则：右键点击.xyz后缀的目录 -> 选择「显示简介」-> 找到「打开方式」模块 -> 选择默认打开程序为「文件夹」-> 点击「全部更改」，后续系统就会将所有.xyz后缀的条目识别为目录，Chrome选择器即可正常选中。

• 方案4：调整目录命名规则
  如果可以控制目录的生成规则，直接去掉目录的.xyz后缀，或者将后缀改为下划线分隔的格式比如thisisfolder_xyz，就不会触发macOS的包识别逻辑，所有平台都可以正常识别为目录。

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