将文件名作为函数入参传递时触发FileNotFoundError报错如何解决？

排查步骤 #

1. 验证传入参数的真实值
   肉眼可见的字符串内容和实际存储内容可能存在差异，比如前后包含空格、换行符、零宽空格等不可见字符，或存在全角/半角字符混用的情况。请在processEntry函数开头加入以下调试代码，对比传入参数与硬编码字符串的差异：

def processEntry(file):  
    print("Processing...")
    # 新增调试代码
    print(f"传入参数repr值：{repr(file)}")
    print(f"硬编码字符串repr值：{repr('test.xlsx')}")
    print(f"两者是否完全相等：{file == 'test.xlsx'}")
    # 原有代码
    try:
        pathToFile = os.path.join(PATH, file)
        # ...

repr()方法会显式打印字符串中的所有不可见字符，如果两者输出不一致，说明传入的file变量实际值和预期的test.xlsx并不相同，多为复制文件名时不小心带入多余不可见字符导致。

2. 对比拼接生成的完整路径
   如果参数值完全一致，继续打印两种场景下拼接的完整路径，确认路径是否一致：

# 传参场景
pathToFile = os.path.join(PATH, file)
print(f"传参场景生成路径：{repr(pathToFile)}")
# 硬编码场景
internalPath = os.path.join(PATH, 'test.xlsx')
print(f"硬编码场景生成路径：{repr(internalPath)}")
print(f"路径是否相等：{pathToFile == internalPath}")

你可以将打印出的路径手动复制到系统文件管理器中打开，确认路径对应的文件是否真实存在。

3. 验证目录下的文件列表
   如果路径一致仍报错，打印脚本所在目录下的所有文件，确认目标文件确实在该目录中：

print(f"脚本所在目录：{repr(PATH)}")
print(f"目录下所有文件：{os.listdir(PATH)}")

常见问题原因 #

该问题90%以上的概率是传入的file参数存在不可见字符，比如从其他地方复制粘贴文件名时，带入了零宽空格、换行符等肉眼无法识别的内容，看起来和test.xlsx完全一致，但实际字符串并不相等。如果调试后确认参数完全相等，可检查系统是否开启了「隐藏已知文件类型扩展名」功能，存在实际文件名为test.xlsx.xlsx的情况，硬编码时刚好写对了完整文件名，传入参数时只写了test.xlsx导致不匹配。

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