PowerShell批量重命名移动图片报错及文件名重复问题求助

核心需求：对多文件夹下的图片文件按规则重命名后，移动到指定目标文件夹。当前运行脚本出现两个问题：

• 多数文件名重复，甚至因字符数超限报错
• 触发「找不到路径的一部分」错误

原脚本 #

# 源目录
$srcdir = "<Source Directory>"

# 输出目录
$opdir = "<output directory>"

# 遍历源目录，仅列出文件夹并存储到$folders变量
$folders = Get-ChildItem $srcdir | Where-Object {$_.PSIsContainer} | Foreach-Object {$_.Name}

# 循环处理源目录下的每个子目录
foreach ($dir in $folders) {

    # 设置工作目录
    Set-Location $srcdir\$dir

            # JPG文件处理
            Get-ChildItem -Filter *.jpg | Rename-Item -NewName {"Y1" + $dir.replace('.3', '.5') + "_" + $_.Name }

            Get-ChildItem -Filter *.jpg | Move-Item -Destination ($opdir)

            # JPEG文件处理
            Get-ChildItem -Filter *.jpeg | Rename-Item -NewName {"Y1" + $dir.replace('.3', '.5') + "_" + $_.Name }

            Get-ChildItem -Filter *.jpeg | Move-Item -Destination ($opdir)

            # PNG文件处理
            Get-ChildItem -Filter *.png | Rename-Item -NewName {"Y1" + $dir.replace('.3', '.5') + "_" + $_.Name }

            Get-ChildItem -Filter *.png | Move-Item -Destination ($opdir)

            # GIF文件处理
            Get-ChildItem -Filter *.gif | Rename-Item -NewName {"Y1" + $dir.replace('.3', '.5') + "_" + $_.Name }

            Get-ChildItem -Filter *.gif | Move-Item -Destination ($opdir)

            # TIFF文件处理
            Get-ChildItem -Filter *.tiff | Rename-Item -NewName {"Y1" + $dir.replace('.3', '.5') + "_" + $_.Name }

            Get-ChildItem -Filter *.tiff | Move-Item -Destination ($opdir)

            Write-Host "`n所有图片已重命名并从目录移动完成: " $srcdir\$dir

            # 将剩余文件移至回收站
            del *.*

            Write-Host "已删除以下目录的剩余文件: " $srcdir\$dir

            Set-Location $srcdir

            Write-Host "已切换至目录: " $srcdir

            rmdir $srcdir\$dir

            Write-Host "已删除目录: " $srcdir\$dir "`n"

        }


Write-Host "`n`n*****************************************"
Write-Host "脚本执行完毕..."
Write-Host "*****************************************"

错误信息 #

Rename-Item : 找不到路径的一部分。
At C:\Users\admin.ph\Desktop\FileMover.ps1:17 char:43
+ ... ter *.jpg | Rename-Item -NewName {"Y1" + $dir.replace('.3', '.5') + " ...
+                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : WriteError: (C:\Users\admin.....5_00427993.jpg:String) [Rename-Item], DirectoryNotFoundException
    + FullyQualifiedErrorId : RenameItemIOError,Microsoft.PowerShell.Commands.RenameItemCommand

问题分析与解决方案 #

核心问题点 #

1. 路径错误原因：
   • 使用Set-Location切换目录时，若目录名含特殊字符（如空格），路径拼接易解析失败
   • 先重命名再移动的两步操作，可能因文件状态变化导致第二次Get-ChildItem无法定位文件
2. 文件名问题原因：
   • 前缀+原文件名的命名规则易超出Windows默认260字符路径限制
   • 不同子目录下的同名文件移动到目标目录后会重复，引发覆盖或报错

优化后的脚本 #

# 源目录（请替换为完整路径）
$srcdir = "你的源目录完整路径"

# 输出目录（请替换为完整路径）
$opdir = "你的输出目录完整路径"

# 提前创建输出目录（若不存在）
if (-not (Test-Path -Path $opdir)) {
    New-Item -ItemType Directory -Path $opdir | Out-Null
}

# 遍历源目录下的所有子目录（直接获取目录对象，避免路径拼接问题）
Get-ChildItem -Path $srcdir -Directory | ForEach-Object {
    $currentDir = $_
    $namePrefix = "Y1" + $currentDir.Name.Replace('.3', '.5') + "_"

    # 一次性获取所有需处理的图片文件
    $imageFiles = Get-ChildItem -Path $currentDir.FullName -File -Include *.jpg, *.jpeg, *.png, *.gif, *.tiff

    foreach ($file in $imageFiles) {
        $ext = $file.Extension
        $baseName = $file.BaseName

        # 处理文件名过长：截断原文件名，确保总长度不超限
        $maxBaseLength = 200 - $namePrefix.Length - $ext.Length
        if ($baseName.Length -gt $maxBaseLength) {
            $newFileName = $namePrefix + $baseName.Substring(0, $maxBaseLength) + $ext
        } else {
            $newFileName = $namePrefix + $file.Name
        }

        # 处理同名文件：自动添加序号避免重复
        $destPath = Join-Path -Path $opdir -ChildPath $newFileName
        $counter = 1
        while (Test-Path -Path $destPath) {
            $newFileName = $namePrefix + $baseName + "_$counter" + $ext
            $destPath = Join-Path -Path $opdir -ChildPath $newFileName
            $counter++
        }

        # 一步完成移动+重命名，避免路径问题
        Move-Item -Path $file.FullName -Destination $destPath -Force
    }

    Write-Host "`n所有图片已从目录移动并重命名完成: " $currentDir.FullName

    # 删除当前目录下的非图片文件
    Get-ChildItem -Path $currentDir.FullName -File | Where-Object {
        $_.Extension -notin ('.jpg', '.jpeg', '.png', '.gif', '.tiff')
    } | Remove-Item -Recurse -Force -ErrorAction SilentlyContinue

    Write-Host "已删除以下目录的剩余文件: " $currentDir.FullName

    # 删除空目录
    Remove-Item -Path $currentDir.FullName -Recurse -Force -ErrorAction SilentlyContinue
    Write-Host "已删除目录: " $currentDir.FullName "`n"
}

Write-Host "`n`n*****************************************"
Write-Host "脚本执行完毕..."
Write-Host "*****************************************"

优化说明 #

1. 彻底解决路径问题：
   • 直接使用目录对象的FullName属性，无需切换工作目录，避免路径拼接错误
   • 将重命名与移动合并为一步Move-Item，减少中间步骤的出错概率
2. 解决文件名问题：
   • 提前检查并截断过长的原文件名，避免超出Windows路径长度限制
   • 自动检测目标目录的同名文件，添加序号防止重复覆盖
3. 提升脚本效率：
   • 一次性获取所有图片文件，避免多次调用Get-ChildItem
   • 提前创建输出目录，避免因目录不存在导致的移动失败

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