如何用PowerShell分割文件名并批量重命名目录文件？

核心问题排查与解决步骤 #

假设你已能通过分割逻辑得到目标文件名部分，重命名失败通常源于以下几个常见问题，对应解决方案如下：

1. 路径处理错误 #

新手常忽略文件完整路径，仅用文件名执行重命名会导致PowerShell无法定位文件。

• 正确做法：遍历文件时使用FullName属性获取完整路径，而非仅取Name。
  示例代码框架：

# 获取C:\Test下的所有文件（-File参数确保只遍历文件，不含文件夹）
$files = Get-ChildItem -Path "C:\Test" -File

foreach ($file in $files) {
    # 替换为你的分割逻辑，示例：按下划线分割后取第2部分，保留原扩展名
    $newFileName = $file.Name.Split("_")[1] + $file.Extension
    # 拼接新的完整路径
    $newFullPath = Join-Path -Path $file.DirectoryName -ChildPath $newFileName
    # 执行重命名，-Force参数覆盖同名文件（谨慎使用）
    Rename-Item -Path $file.FullName -Destination $newFullPath -Force
}

2. 新文件名重复 #

若多个文件分割后得到相同新文件名，重命名会直接失败。可添加重复判断自动生成唯一文件名：

$files = Get-ChildItem -Path "C:\Test" -File

foreach ($file in $files) {
    $targetPart = $file.Name.Split("_")[1]
    $newFileName = "$targetPart$($file.Extension)"
    $newFullPath = Join-Path -Path $file.DirectoryName -ChildPath $newFileName
    
    # 若新路径已存在，自动追加数字后缀
    $counter = 1
    while (Test-Path -Path $newFullPath) {
        $newFileName = "$targetPart_$counter$($file.Extension)"
        $newFullPath = Join-Path -Path $file.DirectoryName -ChildPath $newFileName
        $counter++
    }
    
    Rename-Item -Path $file.FullName -Destination $newFullPath -Force
}

3. 权限或文件占用问题 #

• 右键PowerShell选择「以管理员身份运行」，确保拥有C:\Test目录的修改权限。
• 检查目标文件是否被其他程序（如记事本、图片查看器）占用，关闭后再执行脚本。

4. 分割结果含非法字符 #

文件名不能包含\ / : * ? " < > |这些字符，若分割结果包含这类字符，需先清理：

# 获取系统定义的文件名非法字符
$invalidChars = [System.IO.Path]::GetInvalidFileNameChars()
$files = Get-ChildItem -Path "C:\Test" -File

foreach ($file in $files) {
    $splitParts = $file.Name.Split("_")
    # 确保分割后有足够的有效部分
    if ($splitParts.Count -ge 2 -and $splitParts[1]) {
        # 移除非法字符
        $cleanName = $splitParts[1] -replace "[$([regex]::Escape($invalidChars))]", ""
        $newFileName = $cleanName + $file.Extension
        $newFullPath = Join-Path -Path $file.DirectoryName -ChildPath $newFileName
        
        Rename-Item -Path $file.FullName -Destination $newFullPath -Force
    } else {
        Write-Host "跳过文件 $($file.Name)：分割结果无效"
    }
}

调试技巧 #

若仍失败，可在重命名前添加输出语句，直观检查新文件名和路径是否正确：

Write-Host "待重命名：$($file.FullName) → $newFullPath"

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