PowerShell使用目录变量筛选e02开头文件并重命名异常排查

• 重复调用Get-ChildItem产生冗余查询：$dirFiltered已经存储了筛选完成的文件对象，后续再次对该变量执行Get-ChildItem，会将变量内每个文件的路径作为新的查询根节点遍历，最终返回超出预期的文件列表。
• 循环嵌套导致重命名逻辑混乱：外层ForEach-Object遍历筛选结果的代码块内部，又重新遍历全量$dirFiltered文件执行重命名，会导致所有文件被反复执行重命名操作，最终文件名完全错乱。
• 匹配规则覆盖不全：现有if/elseif逻辑仅匹配e023、e024两个文件名，未覆盖实际场景下e021234这类真实文件名，且无兜底逻辑，未匹配的文件会拿到空的$name值导致重命名报错。
• 重命名操作未绑定当前遍历对象：重命名语句没有指定要操作的单个目标文件，会对全量筛选结果执行统一重命名，触发同名文件冲突报错。

采用哈希表存储固定的文件名-目标名映射，替代冗余的if/else判断，仅遍历一次筛选后的文件集合，匹配到映射规则的文件才执行重命名，未匹配的文件自动跳过：

# 配置工作目录路径
$targetDir = "C:\MYPATH\SAMPLE\"
Set-Location $targetDir

# 固定文件名映射表，后续新增对应关系直接在表内加键值对即可
$nameMapping = @{
    "e021234" = "Program Alpha"
    "e021235" = "Program Beta"
    "e021236" = "Program Gamma"
    "e023"    = "Three"
    "e024"    = "Four"
}

# 筛选目录下BaseName以e02开头的文件，加-File参数确保不返回目录对象
$filteredFiles = Get-ChildItem -Path $targetDir -File | Where-Object { $_.BaseName -like "e02*" }

# 逐个处理筛选到的文件
foreach ($file in $filteredFiles) {
    if ($nameMapping.ContainsKey($file.BaseName)) {
        $newFileName = $nameMapping[$file.BaseName] + ".txt"
        # 首次测试时可加上-WhatIf参数，仅预览操作不实际修改文件：
        # Rename-Item -Path $file.FullName -NewName $newFileName -WhatIf
        Rename-Item -Path $file.FullName -NewName $newFileName -Force
        Write-Host "重命名完成：$($file.Name) -> $newFileName"
    }
    else {
        Write-Host "跳过未配置映射规则的文件：$($file.Name)"
    }
}

操作提示：首次运行建议先给Rename-Item加上-WhatIf参数，控制台会打印所有待执行的重命名操作，确认映射关系、目标文件名完全符合预期后，再去掉该参数正式执行，避免误修改文件。

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