在Kotlin项目中查找首个指定文件名的匹配文件

Java 实现（基于FileTreeWalk） #

Java 12及以上版本的FileTreeWalk原生支持遍历短路操作，能在找到第一个匹配文件后立即终止遍历，无需扫描全部目录：

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Optional;

public class FirstFileSearch {
    public static void main(String[] args) {
        Path rootDir = Paths.get("/path/to/your/project/root");
        String targetFileName = "someFileName";

        Optional<Path> firstMatch = Files.walk(rootDir)
                .filter(path -> path.getFileName().toString().equals(targetFileName))
                .findFirst();

        firstMatch.ifPresentOrElse(
                path -> System.out.println("找到第一个匹配文件: " + path),
                () -> System.out.println("未找到目标文件")
        );
    }
}

• Files.walk()默认采用深度优先遍历，可通过第二个参数指定最大遍历深度（比如Files.walk(rootDir, 2)只搜索当前目录和一级子目录）
• findFirst()是短路操作，找到第一个符合过滤条件的文件后会立刻终止遍历，减少IO开销

Python 实现（手动终止遍历） #

用os.walk()配合条件判断，找到目标文件后直接返回结果终止遍历：

import os

def find_first_file(root_dir, target_name):
    for dirpath, _, filenames in os.walk(root_dir):
        if target_name in filenames:
            return os.path.join(dirpath, target_name)
    return None

# 调用示例
project_root = "/path/to/your/project/root"
target_file = "someFileName"
result = find_first_file(project_root, target_file)

print(f"找到第一个匹配文件: {result}" if result else "未找到目标文件")

• os.walk()默认是广度优先遍历（先扫当前目录，再遍历子目录），若需深度优先可调整遍历逻辑
• 一旦在当前目录的文件列表中匹配到目标文件名，立即拼接完整路径返回，终止整个遍历流程

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