使用Python pathlib跨文件夹重命名文件的代码无报错但功能未生效问题排查

首先定位循环是否正常执行 #

代码完全无报错却没有任何操作，90%的概率是文件列表为空，循环根本没有进入：

• 在文件收集的列表推导后增加实时打印，确认扫描结果：

p1 = Path(AnalyticsDir)
files = [e for e in p1.iterdir() if e.is_file()]
print(f"实际扫描路径: {p1.resolve()}, 匹配到的文件总数: {len(files)}")

• 如果打印出的文件数为0，对应两类高频场景：
  • 目录下的所有目标文件都是失效软链接，is_file()方法对失效软链接返回False，直接被过滤逻辑排除
  • 运行代码的账号对目标目录没有读取权限，虽然iterdir()不会抛出权限错误，但无法枚举到目录下的实际文件

检查代码本身的依赖与逻辑漏洞 #

• 代码中使用了re.sub做文件名替换，但全文没有导入re模块。如果是在交互式Python环境运行，之前的操作恰好导入过re，就不会触发NameError；如果是独立脚本运行，这步会直接报错中断
• 正则匹配规则和实际文件名不兼容：代码用的匹配规则是连续8位纯数字\d{8}，如果实际文件名里的日期带分隔符（比如报表_2021.03.31.xlsx），正则完全无法命中，导致替换前后文件名完全一致
• 开头几行基于pandas计算季度日期的代码使用了废弃API：pd.datetime.today()在pandas 2.0+版本已经被彻底移除，运行时会直接抛出AttributeError。如果没有注释这几行，代码会在进入文件循环前就中断，根本不会执行后续的文件操作

排查静默失效的移动行为 #

• 目标子文件夹如果已经存在，且里面已有和待移动文件同名的文件，Path.rename()在类Unix系统下会直接覆盖目标文件。如果新旧文件内容完全一致，会让人误以为代码没有执行任何移动操作
• 验证方式：在执行rename的前后增加打印，明确每一步的源路径、目标路径：

print(f"待处理文件: {file.resolve()}, 目标路径: {p3.resolve()}")
file.rename(p3)
print(f"移动后目标路径是否存在: {p3.exists()}")

修复后可直接运行的代码 #

from pathlib import Path
import re
import pandas as pd

# 修复废弃API的日期计算逻辑
quarter_end = pd.Timestamp.today() - pd.tseries.offsets.QuarterEnd(startingMonth=3)
QE_Dir = quarter_end.strftime("%m.%d.%Y")
QE = quarter_end.strftime("%Y%m%d")

# 测试用硬编码配置
# QE_Dir = '03.31.2021'
AnalyticsDirs = ['/home/javert/Dir1/Dir2/ACG']

for AnalyticsDir in AnalyticsDirs:
    p1 = Path(AnalyticsDir)
    # 提前创建目标子文件夹，避免循环内重复创建的开销
    p2 = p1.joinpath(QE_Dir)
    p2.mkdir(parents=True, exist_ok=True)
    
    # 遍历目录直接子项，排除子目录、非文件类型的条目
    for file in p1.iterdir():
        if not file.is_file():
            continue
        new_name = re.sub(r'\d{8}', QE, file.name)
        target_path = p2.joinpath(new_name)
        # 用replace替代rename，跨平台行为一致，目标文件存在时自动覆盖
        file.replace(target_path)

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