Python os.scandir()格式化输出问题排查与最佳实践咨询

问题1：输出携带None值的原因与修复 #

第一段代码中的filetype函数没有显式写return语句，Python所有函数默认无返回值时会返回None，你赋值给resourcetype的就是这个默认返回的None。而你在filetype内部调用的多个print直接把类型字符串输出到了标准输出，所以最终输出才会出现file None:这种拼接结果：前面的file是filetype里的print输出的，后面的None是你传入format的resourcetype的值。
修复方法很简单：不要在函数内部直接print类型，而是把类型字符串拼接好返回即可。你后续提供的优化版本已经解决了这个问题，还可以进一步简化，不需要额外创建字典：

def get_file_type(entry):
    if entry.is_symlink():
        return "link"
    elif entry.is_dir():
        return "dir"
    elif entry.is_file():
        return "file"
    elif os.path.ismount(entry):
        return ".."
    return "unknown"

问题2：文件名调整到第二位且对齐的实现 #

用Python格式化字符串的固定宽度语法即可实现对齐，指定字段的固定长度+左对齐规则，超出长度的内容也会正常显示不会截断，示例写法是f"{entry.name:<20}"，代表给entry.name预留20个字符的宽度，内容左对齐，不足的位置补空格。
优化后的完整可运行代码如下：

import os
import time

def scandir_list(basedir):
    # 各列固定宽度可根据实际需求调整
    TYPE_WIDTH = 6
    NAME_WIDTH = 25
    SIZE_WIDTH = 10
    with os.scandir(basedir) as entries:
        for entry in entries:
            # 获取资源类型
            if entry.is_symlink():
                res_type = "link"
            elif entry.is_dir():
                res_type = "dir"
            elif entry.is_file():
                res_type = "file"
            elif os.path.ismount(entry):
                res_type = ".."
            else:
                res_type = "unknown"
            # 计算大小、修改时间
            size_kb = round(os.path.getsize(entry)/1024, 2)
            mtime = time.ctime(os.path.getmtime(entry))
            # 格式化输出：类型 -> 名称 -> 大小 -> 修改时间，固定宽度对齐
            print(f"{res_type:<{TYPE_WIDTH}} {entry.name:<{NAME_WIDTH}} Size: {size_kb:<{SIZE_WIDTH}} kb Last Modified: {mtime}")

if __name__ == "__main__":
    basedir = os.path.dirname(__file__)
    scandir_list(basedir)

附加问题解答 #

1. 注释的while循环方案无法达到预期的原因 #

你注释的逻辑存在两个核心问题：

• 赋值逻辑直接覆盖：每次给result赋值都会直接覆盖上一次的结果，比如如果是目录类型的符号链接，先赋值dir，再判断是link又会覆盖成link，最终只能拿到最后一个判断条件的结果，无法正确标记多属性的资源
• 循环无退出条件：while的判断条件是result为空/None，但循环体内没有修改循环终止条件的逻辑，只要进入循环就会无限死循环
  更合理的替代方案就是上面写的多分支判断逻辑，或者用列表收集符合的类型标签最后join成字符串。

2. os.scandir()和os.listdir()的优劣与互补 #

互补场景：

• 只需要快速获取目录下所有文件名，不需要任何元信息时，用os.listdir()代码更轻量
• 需要判断文件类型、获取大小、修改时间等元信息，或者递归遍历目录时，优先用os.scandir()，性能和可读性都更好，Python 3.5+内置的os.walk()已经默认用os.scandir()实现来提升性能。

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