使用if/elif语句时遭遇UnboundLocalError：变量fileName未赋值即引用

嘿，这个错误我之前踩过好几次坑！咱们来快速搞懂它的根源，然后解决你的问题～

错误原因拆解 #

这个报错的核心问题是：你的fileName变量只在部分if/elif分支里被赋值了，但程序执行时如果走到了没给它赋值的分支，后续引用它就会触发这个错误。

举个模拟你场景的例子（大概是你代码的结构）：

def clean_filename(input_str):
    if re.match(r'^前缀A', input_str):
        fileName = re.sub(r'^前缀A', '', input_str)
    elif re.match(r'^前缀B', input_str):
        fileName = re.sub(r'^前缀B', '', input_str)
    # 这里如果input_str既不是前缀A也不是前缀B，fileName根本没被定义！
    folder_name = get_folder_name(fileName)
    return fileName, folder_name

看到没？当输入的文件名不匹配任何if/elif的条件时，fileName从来没被赋值过，后面调用get_folder_name(fileName)或者返回它时，Python就会报错说“引用前未赋值”。

另外还有一种少见但可能的情况：如果fileName是全局变量，但你在函数的某个分支里给它赋值了，Python会自动把它当成局部变量，这时候其他分支没赋值的话也会触发同样的错误。

两种快速解决方法 #

1. 提前给fileName设置默认值

在if/elif语句块的最前面，先给fileName一个默认值，这样不管走哪个分支，变量都有定义：

def clean_filename(input_str):
    # 默认返回原文件名，或者根据你的业务逻辑设成空字符串/其他合理值
    fileName = input_str
    if re.match(r'^前缀A', input_str):
        fileName = re.sub(r'^前缀A', '', input_str)
    elif re.match(r'^前缀B', input_str):
        fileName = re.sub(r'^前缀B', '', input_str)
    folder_name = get_folder_name(fileName)
    return fileName, folder_name

2. 用else分支覆盖所有剩余情况

如果默认值不符合你的业务逻辑，那就加一个else分支，要么给fileName赋值，要么抛出明确的错误，避免遗漏情况：

def clean_filename(input_str):
    if re.match(r'^前缀A', input_str):
        fileName = re.sub(r'^前缀A', '', input_str)
    elif re.match(r'^前缀B', input_str):
        fileName = re.sub(r'^前缀B', '', input_str)
    else:
        # 要么处理其他情况，要么抛出错误提示非法输入
        raise ValueError(f"无法识别的文件名格式：{input_str}")
    folder_name = get_folder_name(fileName)
    return fileName, folder_name

总结一下 #

核心原则就是：确保fileName在被任何代码引用之前，无论程序走哪个分支路径，都已经被赋值过。按照上面的方法调整你的代码，这个错误应该就消失啦～

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