PowerShell foreach循环重命名文件异常：迭代次数超出预期

云原生阿岚

2026-8-7

PowerShell批量重命名文件时循环次数超标问题解决

问题根源

你遇到的循环次数超出文件实际数量的情况，核心原因是直接遍历动态文件集合时修改文件名，导致集合实时刷新引发重复/额外迭代。

PowerShell中Get-ChildItem默认返回的是动态的FileInfo集合，当你在循环内重命名文件时，系统会实时重新扫描目录并更新这个集合——原本的文件被重命名后，新文件名可能会被再次纳入集合，导致循环多跑一次甚至多次。

解决方案

1. 先将文件存入静态数组再遍历

把所有要处理的文件提前存入数组，让遍历的集合固定下来，不受后续文件重命名的影响：

# 指定目标目录路径
$targetDir = "C:\你的目标目录"
# 先一次性获取所有xlsx文件存入静态数组
$xlsxFiles = Get-ChildItem -Path $targetDir -Filter *.xlsx -File

# 获取用户输入的前缀并验证
do {
    $prefix = Read-Host "请输入前缀（F/O）"
} while ($prefix -notin @('F', 'O'))

# 遍历数组执行重命名
foreach ($file in $xlsxFiles) {
    $newFileName = "$prefix-$($file.Name)"
    Rename-Item -Path $file.FullName -NewName $newFileName -Force
}

2. 使用管道配合`ForEach-Object`一次性处理

管道会先把所有Get-ChildItem的结果收集完，再传递给ForEach-Object处理，同样能避免动态集合的问题：

$targetDir = "C:\你的目标目录"

do {
    $prefix = Read-Host "请输入前缀（F/O）"
} while ($prefix -notin @('F', 'O'))

Get-ChildItem -Path $targetDir -Filter *.xlsx -File | ForEach-Object {
    $newFileName = "$prefix-$($_.Name)"
    Rename-Item -LiteralPath $_.FullName -NewName $newFileName -Force
}