Python项目变量作用域与文件路径错误排查求助

问题概述 #

项目中先后出现两类错误：

• 初始报错UnboundLocalError：无法访问未赋值的局部变量path_
• 调整代码（移除无用全局声明、重命名参数、给path_赋初始值）后，出现FileNotFoundError：提示路径'poeple info'不存在

示例代码 #

import os

temp_variable = [0, 1, 2, 3]

if len(temp_variable) > 1:
      temp_variable = temp_variable[0] # This is a variable

for element in os.listdir(temp_variable): # here the "temp_variable is list instead of a integer  
     dosomething()

核心源码 #

import os
import typing

# 假设WD是已定义的全局变量
WD = ""

def not_around(gpath, home_path) -> list[str]:
    dirs_for_filter: list[str] = []

    for root, Gdir, Gfiles in os.walk(home_path):
            for i in range(len(Gdir)):
                if Gdir[i] in [gpath.split('/')[-1]]:

                    gpath: str = root[0:] + '/' + Gdir[i]
                    print(gpath)
                    prossesed_copy_path: str = gpath
                    dirs_for_filter.append(prossesed_copy_path)
    return dirs_for_filter


def filter(arg_path: str =WD, *, is_around: bool =True, skipped: typing.Union[None, list[str]] =None):
    # 全局变量假设已定义
    global files, dirs
    files = []
    dirs = []

    path = arg_path
    path_ = path
    print("path from start: " + path)
    
    input_copy_path: str = path

    temp_files: list[str] = []
    temp_dirs: list[str] = []
    repeted_dirs: list[str] = []

    if not is_around:
        repeted_dirs = not_around(path, '/home')
        path = repeted_dirs

    if len(path) > 1: # The if statement 
        print(f"""There a {len(repeted_dirs)} file that have the same name of {input_copy_path}.""")
        i: int = 1
        for dir in repeted_dirs:
            if i == 1:
                print(f"\n\n    {i}. The {input_copy_path} in [  {repeted_dirs[i]}  ] folder")
                i += 1
                continue
            print(f"    {i}. The {input_copy_path} in [  {repeted_dirs[i - 2]}  ] folder")
            i += 1
        print(f"    {i}. All of them\n")
        try:
            response: int = int(input('Choose one of the available options by passing it\'s number: '))
            response -= 1
        except ValueError:
            print("This is not in the valed.")

        if response == len(repeted_dirs) + 1:
            print("This future is not available yat.")  #   Make this dream in reality :) 
            exit(1)

        path_ = path[response]

    for element in os.listdir(path=path_): # The for loop
        if skipped != None:
            if element in [file_ for file_ in skipped]:  # ["voldemorts.py", "salt.salt", "password.txt"]
                continue

        if element in ["voldemorts.py", "salt.salt"]:
            continue
        
        element = os.path.join(path, element)
            
        if os.path.isfile(element):
            temp_files.append(element)

        if os.path.isdir(element):
            temp_dirs.append(element)

    for i in range(len(temp_files)):
        files.append(temp_files[i])

    for i in range(len(temp_dirs)):
        dirs.append(temp_dirs[i])

    if temp_dirs != []:
        for i in range(len(temp_dirs)):
            filter(os.path.join(path, temp_dirs[i]))

        return dirs, files

    return temp_dirs, temp_files

初始报错信息 #

Traceback (most recent call last):
  File "/media/twister_froste/CAE8-23EA/ransomware/voldemorts.py", line 234, in <module>
    for _file in filter(file, is_around=False, skipped=None)[1]:
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/media/twister_froste/CAE8-23EA/ransomware/voldemorts.py", line 146, in filter
    for element in os.listdir(path=path_):
                                   ^^^^^
UnboundLocalError: cannot access local variable 'path_' where it is not associated with a value

修改后报错信息 #

Enter the password for encryption: 
path from start: poeple info
Traceback (most recent call last):
  File "/media/twister_froste/CAE8-23EA/ransomware/voldemorts.py", line 233, in <module>
    for _file in filter(file, is_around=False, skipped=None)[1]:
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/media/twister_froste/CAE8-23EA/ransomware/voldemorts.py", line 145, in filter
    for element in os.listdir(path=path_):
                   ^^^^^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'poeple info'

问题排查与修复建议 #

1. 路径拼写与存在性验证 #

• 检查路径'poeple info'是否为拼写错误（大概率应为'people info'），手动确认该路径在系统中是否真实存在，尤其是在/home目录下是否有对应目录。
• 在调用os.listdir前增加路径存在性检查：

  if not os.path.exists(path_):
      print(f"Error: Path {path_} does not exist.")
      return [], []
  

2. 修复not_around函数的逻辑漏洞 #

• 当not_around函数未找到同名目录时，返回空列表，此时path被赋值为空列表，len(path) <=1不会进入分支修改path_，导致path_仍为初始的无效路径。需增加无匹配目录的处理逻辑：

  if not is_around:
      repeted_dirs = not_around(path, '/home')
      if not repeted_dirs:
          print(f"No directories matching {path} found under /home.")
          return [], []
      path = repeted_dirs
  

3. 修正索引遍历错误 #

• 原代码中遍历repeted_dirs时索引逻辑混乱（如repeted_dirs[i]当i=1时会索引越界），改用enumerate简化遍历：

  print(f"There are {len(repeted_dirs)} directories named {input_copy_path}.")
  for idx, dir_path in enumerate(repeted_dirs, 1):
      print(f"    {idx}. {input_copy_path} in [ {dir_path} ] folder")
  print(f"    {len(repeted_dirs)+1}. All of them\n")
  

4. 修复递归调用的路径问题 #

• 当is_around=False时，path是列表类型，直接用于os.path.join会生成无效路径，需确保递归时传入的是字符串路径：

  if temp_dirs != []:
      # 确保递归时使用正确的路径字符串
      base_path = path_[0] if isinstance(path, list) else path
      for dir_name in temp_dirs:
          filter(os.path.join(base_path, dir_name))
  

5. 变量类型一致性保障 #

• path变量在不同分支下类型不一致（字符串/列表），需明确变量类型，避免后续逻辑出错：

  # 确保path始终为字符串或处理列表的逻辑统一
  if not is_around:
      repeted_dirs = not_around(path, '/home')
      if len(repeted_dirs) == 1:
          path = repeted_dirs[0]
      elif len(repeted_dirs) >1:
          # 进入选择分支
          ...
      else:
          # 无匹配处理
          ...
  

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