如何让Python os.walk在不同文件系统下的符号链接行为一致？

目录结构 #

fs
├── data1.txt
├── data2.txt
├── data3.txt
├── dir
│   ├── file1.txt
│   ├── file2.txt
│   └── file3.txt
└── sym -> dir

测试1：本地卷目录 #

该目录位于macOS的本地APFS磁盘中，运行以下Python代码：

for dirpath, subdirs, filenames in os.walk('/path/to/fs'):
    print(f"{dirpath=}\n{subdirs=}\n{filenames=}\n") 

返回结果中sym被归类在subdirs目录列表中。

测试2：挂载的Samba共享目录 #

将fs目录复制到Synology NAS的挂载Samba共享卷中，运行相同代码，返回结果中sym被归类在filenames文件列表中。

问题 #

如何让os.walk在两种文件系统下表现一致？是否需要遍历subdirs和filenames，检查条目是否为符号链接并手动调整？

注意： 不想设置followlinks=True，避免无限递归风险。

补充细节 #

通过ls -l查看两个目录，均显示sym为符号链接，但Python为何会区别对待？

原因分析 #

os.walk对符号链接的归类逻辑依赖底层文件系统返回的文件类型信息。Samba共享在处理符号链接时，未向Python的os模块正确返回目录类型标识——虽然ls -l能识别出是符号链接，但Python通过系统调用获取文件属性时，Samba返回的是普通文件类型，导致os.walk将其归入filenames；而本地APFS磁盘则正确返回了符号链接指向目录的类型信息，因此被归入subdirs。

解决方案 #

要实现跨文件系统的一致行为，必须手动校验每个条目的类型，调整subdirs和filenames的内容。以下是具体实现：

import os

def consistent_walk(top):
    for dirpath, subdirs, filenames in os.walk(top, followlinks=False):
        # 合并所有条目，重新分类
        all_entries = subdirs + filenames
        new_subdirs = []
        new_filenames = []
        
        for entry in all_entries:
            entry_path = os.path.join(dirpath, entry)
            if os.path.islink(entry_path):
                # 判断符号链接指向的是否为目录（仅判断目标类型，不进入目录）
                if os.path.isdir(entry_path):
                    new_subdirs.append(entry)
                else:
                    new_filenames.append(entry)
            else:
                # 非符号链接，保留原分类
                if entry in subdirs:
                    new_subdirs.append(entry)
                else:
                    new_filenames.append(entry)
        
        # 替换原列表，确保os.walk后续遍历逻辑不受影响
        subdirs[:] = new_subdirs
        filenames[:] = new_filenames
        
        # 此处可添加自定义处理逻辑，比如打印结果
        print(f"{dirpath=}\n{subdirs=}\n{filenames=}\n")

consistent_walk('/path/to/fs')

说明 #

• 使用subdirs[:] = new_subdirs而非直接赋值，是因为os.walk会通过修改原subdirs列表控制后续遍历的子目录（比如移除条目可跳过对应目录的遍历）
• os.path.isdir()处理符号链接时，仅判断目标是否为目录，不会跟随链接进入目录，因此无无限递归风险

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