如何在gatsby-source-filesystem的allDirectory查询中排除根目录

API 探路者

2026-5-9

解决Gatsby查询allDirectory返回sourceInstance根目录的问题

要去掉查询结果里的dosbox根目录，只保留它的子目录，你可以在GraphQL查询的filter中添加额外条件来过滤掉根目录。这里提供几种可靠的实现方式：

1. 通过`relativePath`过滤（最通用推荐）

Gatsby的Directory节点中，你配置的sourceInstance根目录的relativePath是空字符串，而它的子目录会有对应的相对路径值。利用这一点，我们可以直接排除空值的relativePath条目：

query MyQuery {
  allDirectory(filter: {
    sourceInstanceName: {eq: "dosbox"},
    relativePath: {ne: ""}
  }) {
    edges {
      node {
        name
        dir
        modifiedTime
      }
    }
  }
}

这种方式不依赖目录名称或具体路径，不管你的sourceInstance目录叫什么、路径怎么变，都能稳定生效，还能避免子目录和根目录重名导致的误过滤问题。

2. 通过父目录路径过滤（精确匹配直接子目录）

如果你只需要src/dosbox/下的直接子目录，可以直接指定父目录的路径作为过滤条件：

query MyQuery {
  allDirectory(filter: {
    sourceInstanceName: {eq: "dosbox"},
    dir: {eq: "${__dirname}/src/dosbox/"}
  }) {
    edges {
      node {
        name
        dir
        modifiedTime
      }
    }
  }
}

这个方式会精确匹配父目录为src/dosbox/的目录，适合只需要一级子目录的场景。

3. 通过目录名过滤（简单但有局限性）

如果能确保不会有子目录和根目录同名（比如dosbox），也可以直接排除名字为dosbox的目录：

query MyQuery {
  allDirectory(filter: {
    sourceInstanceName: {eq: "dosbox"},
    name: {ne: "dosbox"}
  }) {
    edges {
      node {
        name
        dir
        modifiedTime
      }
    }
  }
}

注意：如果有子目录也叫dosbox，这个方式会误过滤掉它，所以只适合简单场景。