Python遍历嵌套目录时如何仅筛选列出所有symlink符号链接

需求说明 #

需要遍历多层嵌套目录，过滤掉普通文件、普通子目录，仅返回所有符号链接的完整路径，测试目录结构如下：

output/
output/subdirectory_1/file_1.txt
output/subdirectory_2/file_2.txt
output/subdirectory_2/symlink_1.txt
output/subdirectory_2/subdirectory_2a/symlink_2.txt
output/symlink_3.txt
output/file_3.txt

预期返回3条符号链接路径：

output/subdirectory_2/symlink_1.txt
output/subdirectory_2/subdirectory_2a/symlink_2.txt
output/symlink_3.txt

可用实现 #

1. 基于os.walk的兼容实现（全Python版本支持） #

注意followlinks参数仅控制是否进入符号链接指向的目录遍历内部内容，不影响符号链接本身的识别，无特殊需求不要开启，避免循环链接导致无限递归。

import os

def find_all_symlinks(root: str = ".") -> list[str]:
    symlink_paths = []
    for parent_dir, sub_dirs, files in os.walk(root):
        # os.walk会把当前目录下的子目录、文件拆分返回，合并后遍历所有条目
        for entry_name in sub_dirs + files:
            entry_path = os.path.join(parent_dir, entry_name)
            # os.path.islink不会跟随链接，可准确判断条目是否为符号链接
            if os.path.islink(entry_path):
                symlink_paths.append(entry_path)
    return symlink_paths

# 调用示例
for fp in find_all_symlinks("output"):
    print(fp)

2. 高性能实现（基于os.scandir，适合大数量级目录） #

os.scandir返回的目录条目自带文件属性缓存，比os.walk+手动路径判断的方案减少系统调用，遍历速度更快，通过follow_symlinks=False参数避免进入符号链接指向的目录，从根源规避循环递归问题。

import os

def find_all_symlinks(root: str = ".") -> list[str]:
    symlink_paths = []
    with os.scandir(root) as entries:
        for entry in entries:
            if entry.is_symlink():
                symlink_paths.append(entry.path)
            elif entry.is_dir(follow_symlinks=False):
                # 仅递归遍历真实子目录
                symlink_paths.extend(find_all_symlinks(entry.path))
    return symlink_paths

3. Python 3.12+ 简洁实现（pathlib） #

Python 3.12为pathlib.Path新增了walk方法，写法更符合现代Python风格：

from pathlib import Path

def find_all_symlinks(root: str = ".") -> list[str]:
    symlink_paths = []
    for parent_dir, sub_dirs, files in Path(root).walk():
        for entry_name in sub_dirs + files:
            entry_path = parent_dir / entry_name
            if entry_path.is_symlink():
                symlink_paths.append(str(entry_path))
    return symlink_paths

对你现有代码的评估 #

你当前写的核心判断逻辑是正确的，可以正常筛选出所有符号链接，但存在几个可优化的点：

• followlinks=True存在风险：如果目录内存在指向父级目录的循环符号链接，开启该参数会触发无限递归，最终抛出递归深度错误，无遍历链接指向目录内容的需求时保持默认False即可。
• 多余逻辑可移除：代码中enumerate、pv进度条逻辑和收集符号链接的核心需求无关，不需要索引的场景下可以删除，减少额外开销。
• 性能不是最优：如果需要遍历的文件、目录数量达到数千级以上，os.scandir的递归实现比当前os.walk的写法效率高30%~50%。

内容的提问来源于stack exchange，提问作者O.rka