当循环体未执行（如目录为空）时，变量 dest_eröff 未被初始化即在循环外被访问，导致 UnboundLocalError。正确做法是在循环前显式初始化该变量，并在使用前校验其有效性。
当循环体未执行（如目录为空）时，变量 dest_eröff 未被初始化即在循环外被访问，导致 unboundlocalerror: local variable 'dest_eröff' referenced before assignment。正确做法是在循环前显式初始化该变量，并在使用前校验其有效性。
该错误看似隐蔽，实则源于 Python 的作用域与变量绑定机制：只要在函数/代码块内对某个名称进行了赋值（哪怕只在某个分支中），Python 就会将其视为局部变量；而若该赋值语句因条件未满足而未执行，则后续对该变量的任何读取都会触发 UnboundLocalError。
在您的代码中，dest_eröff 仅在 for 循环内部的两个分支中被赋值：
- 若当前目录中存在以 "Eröff" 开头的文件 → 赋值为已有文件路径；
- 否则（即无匹配文件）→ 按年份生成新文件并赋值。
但关键漏洞在于：如果 dest_dir 为空（os.listdir(dest_dir) 返回空列表），整个 for 循环体将完全跳过，dest_eröff 始终未被定义。此时执行 with open(dest_eröff) as file: 自然抛出异常。
✅ 正确解决方案是 显式初始化 + 安全校验：
import os
from datetime import date
dest_dir = r"I:\My Drive\Programmieren\Buchführung"
# 确保目标目录存在
if not os.path.exists(dest_dir):
os.mkdir(dest_dir)
# ✅ 关键：提前声明并初始化，避免未定义风险
dest_eröff = None
for file_name in os.listdir(dest_dir):
if not file_name.startswith("Eröff"):
start = str(date.today())
dest_eröff = os.path.join(dest_dir, f"Eröffnungbilanz_{start[:4]}")
with open(dest_eröff, 'w') as file:
file.write(f"Eroeffnungsbilanz ({start[:4]})")
else:
dest_eröff = os.path.join(dest_dir, file_name)
# ✅ 关键：仅在变量已有效赋值时才打开文件
if dest_eröff is not None:
with open(dest_eröff) as file:
content = file.read()
# 注意：此处需确保文件内容格式稳定，避免索引越界
try:
start_year = int(content[19:23])
print(f"Detected year: {start_year}")
except (ValueError, IndexError) as e:
raise ValueError("Failed to parse year from file content. Expected 4-digit year at position 19–22.") from e
else:
raise FileNotFoundError("No 'Eröff' file found and no new file was created — check directory permissions or logic.")⚠️ 注意事项：
- 使用原始字符串（r"..."）避免 Windows 路径中的反斜杠转义问题；
- os.listdir() 不递归、不保证顺序，若需精确匹配建议改用 glob 或 pathlib；
- 文件内容解析（content[19:23]）具有强耦合性——一旦写入格式变动（如年份位置偏移或长度变化），将引发 IndexError 或 ValueError，务必添加异常处理；
- 更健壮的做法是：用 pathlib.Path 替代 os 模块，并结合正则匹配文件名（如 r"Eröffnungbilanz_(\d{4})"），提升可维护性。
总结：Python 中“变量必须先赋值再使用”是硬性规则，不存在“隐式声明”或“作用域外继承”。任何可能跳过的赋值路径，都必须通过前置初始化 + 后置校验来兜底。这是编写可靠 Python 代码的基本功之一。
