PowerShell批量重命名图片时循环次数超出预期的问题

问题现象 #

使用PowerShell给561张图片重命名：

1. 第一次将文件重命名为newName_1.jpg到newName_561.jpg，结果正常
2. 第二次将文件重命名为newestName_1.jpg到newestName_561.jpg，结果正常
3. 第三次尝试改回newName_*命名时，结果变成newName_1000.jpg到newName_1560.jpg，循环变量$a最终跑到了1560而非561

执行代码 #

# 第一次重命名
PS E:\PART_5> $a = 1
PS E:\PART_5> Get-ChildItem | ForEach-Object {
>> $name = "newName_$a" + $_.Extension
>> Rename-Item -Path $_.FullName -NewName $name
>> $a = $a + 1
>> }

# 第二次重命名
PS E:\PART_5> $a = 1
PS E:\PART_5> Get-ChildItem | ForEach-Object {
>> $name = "newestName_$a" + $_.Extension
>> Rename-Item -Path $_.FullName -NewName $name
>> $a = $a + 1
>> }

# 第三次重命名（出现异常）
PS E:\PART_5> $a = 1
PS E:\PART_5> Get-ChildItem | ForEach-Object {
>> $name = "newName_$a" + $_.Extension
>> Rename-Item -Path $_.FullName -NewName $name
>> $a = $a + 1
>> }

执行结果对比 #

问题原因 #

Get-ChildItem默认使用动态枚举器，它会实时读取目录内容。当你在循环中重命名文件时：

• 前两次重命名时，新文件名（newName_*/newestName_*）与原文件名无重叠，枚举器不会重复处理文件，循环正常执行561次
• 第三次重命名时，将newestName_*改回newName_*，新生成的newName_*文件会被动态枚举器再次捕获（因为名称排序可能在未处理的newestName_*文件之前），导致循环反复处理这些已重命名的文件，最终计数远超文件总数

解决方法 #

先将所有文件对象一次性读取到内存中，再进行重命名操作，避免动态枚举带来的重复处理：

修正后的代码 #

# 先把所有文件存入数组，完成一次性枚举
$files = Get-ChildItem
$a = 1

$files | ForEach-Object {
    # 拼接新文件名（更简洁的写法）
    $newName = "newName_$a$($_.Extension)"
    Rename-Item -Path $_.FullName -NewName $newName
    $a++
}

或者用ForEach-Object的-Begin参数初始化变量，同时确保先枚举所有文件：

Get-ChildItem | ForEach-Object -Begin { $a = 1 } -Process {
    $newName = "newName_$a$($_.Extension)"
    Rename-Item -Path $_.FullName -NewName $newName
    $a++
}
# 注：此写法在PowerShell 5.1及以上版本中，若目录内容在枚举过程中变化仍可能出问题，更稳妥的方式是先存入数组

这样修改后，第三次重命名会严格执行561次，生成newName_1.jpg到newName_561.jpg的正确结果。

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