PowerShell基于电子表格映射批量重命名文件的问题及优化建议请求

问题修复思路 #

1. 命名冲突问题修复 #

• 根因：Test-Path与Rename-Item执行间隙存在竞争条件，网络共享驱动器读写延迟会导致存在性判断失效；原脚本Rename-Item使用-ErrorAction Continue，命名冲突时不会触发终止逻辑
• 修复点：
  • 重命名操作统一设置-ErrorAction Stop，所有错误都会进入Catch块
  • 存在性判断增加网络路径兼容参数，加入非法字符预校验，避免生成无效文件名后判断失效
  • 计数器逻辑优化，冲突后递增逻辑直接作用于最终拼接的完整文件名

2. 错误捕获异常修复 #

• 根因：PowerShell默认仅捕获终止错误，原脚本未对可能报错的命令统一设置错误动作，且错误记录仅存储了路径和目标名，缺少错误信息导致无法定位
• 修复点：
  • 所有涉及文件读写、重命名的命令统一添加-ErrorAction Stop
  • Catch块同时存储错误原因、原文件路径、目标文件名，方便后续排查
  • 新增非法文件名预校验逻辑，在重命名前就过滤掉包含Windows保留字符的目标名，提前写入错误表

3. 文件漏处理问题修复 #

• 根因：CSV导出字段可能存在首尾空格、文件名大小写匹配偏差、网络驱动器递归扫描漏文件、哈希表匹配规则问题
• 修复点：
  • 导入CSV时对CURRENT、NEW字段统一做首尾空格裁剪，避免隐形字符导致匹配失败
  • 哈希表使用大小写不敏感的匹配规则，消除文件名大小写差异导致的匹配失效
  • 新增预览模式，可先扫描所有文件输出匹配结果，不实际执行重命名，快速定位漏匹配的文件
  • Get-ChildItem添加-Force参数，避免隐藏属性的文件被漏扫描

修正后完整脚本 #

<#
使用方法：
1. 预览模式（仅输出重命名结果，不实际执行）：
.\rename_script.ps1 "目标文件夹路径" "映射表CSV路径" -Preview
2. 实际执行模式：
.\rename_script.ps1 "目标文件夹路径" "映射表CSV路径"
#>
param(
    [Parameter(Mandatory=$true)]
    [string]$Path,
    [Parameter(Mandatory=$true)]
    [string]$Source,
    [switch]$Preview
)

# 初始化大小写不敏感的哈希表，避免大小写匹配失败
$renameMap = [hashtable]::new([StringComparer]::OrdinalIgnoreCase)
$errorMap = @{}
# Windows非法文件名字符集
$invalidChars = [System.IO.Path]::GetInvalidFileNameChars()

# 导入映射表，裁剪首尾空格
Import-Csv -Path $Source -ErrorAction Stop | ForEach-Object {
    $currentName = $_.CURRENT.Trim()
    $newName = $_.NEW.Trim()
    if (-not [string]::IsNullOrEmpty($currentName) -and -not [string]::IsNullOrEmpty($newName)) {
        $renameMap[$currentName] = $newName
    }
}

# 扫描所有文件
Get-ChildItem -Path $Path -File -Recurse -Force | ForEach-Object {
    $file = $_
    $originalFullName = $file.FullName
    if ($renameMap.ContainsKey($file.Name)) {
        try {
            $baseNewName = $renameMap[$file.Name]
            $ext = $file.Extension
            $currentDir = $file.DirectoryName
            $counter = 1
            # 预校验目标名是否包含非法字符
            if ($baseNewName.IndexOfAny($invalidChars) -ge 0) {
                throw "目标文件名包含Windows保留非法字符，无法重命名"
            }
            $finalNewName = $baseNewName + $ext
            $finalFullPath = Join-Path $currentDir $finalNewName
            # 循环判断文件是否存在，处理冲突
            while (Test-Path -Path $finalFullPath -ErrorAction SilentlyContinue) {
                $finalNewName = "${baseNewName}_${counter}${ext}"
                $finalFullPath = Join-Path $currentDir $finalNewName
                $counter++
            }
            if ($Preview) {
                Write-Host "[预览] 重命名: $originalFullName -> $finalFullPath"
            } else {
                $file | Rename-Item -NewName $finalNewName -ErrorAction Stop
                Write-Host "已重命名: $originalFullName -> $finalNewName"
            }
        }
        catch {
            $errorMsg = $_.Exception.Message
            $errorMap[$originalFullName] = @{
                TargetName = $renameMap[$file.Name]
                ErrorInfo = $errorMsg
            }
            Write-Warning "处理失败 $originalFullName : $errorMsg"
        }
    } else {
        # 可选：取消下方注释，记录未匹配到的文件，排查漏处理问题
        # Write-Host "未匹配到映射规则: $originalFullName"
    }
}

# 导出错误日志
$errorMap.GetEnumerator() | ForEach-Object {
    [PSCustomObject]@{
        OriginalFilePath = $_.Key
        TargetName = $_.Value.TargetName
        ErrorInformation = $_.Value.ErrorInfo
    }
} | Export-Csv -Path "重命名错误日志_$(Get-Date -Format 'yyyyMMddHHmmss').csv" -NoTypeInformation -Encoding UTF8

if ($Preview) {
    Write-Host "预览模式执行完成，未修改任何文件，错误日志已生成"
} else {
    Write-Host "重命名操作执行完成，错误日志已生成"
}

漏处理问题排查建议 #

1. 先使用预览模式运行脚本，取消掉未匹配文件日志的注释，输出所有未匹配到映射的文件，对比映射表的CURRENT列，检查是否存在拼写差异、隐形空格、扩展名不匹配问题
2. 确认CSV文件的表头是否严格为CURRENT和NEW，大小写不影响但不能有拼写错误或多余空格
3. 确认映射表CURRENT列的文件名是否包含扩展名，需和实际文件的全名（含扩展名）完全一致

内容的提问来源于stack exchange，提问作者dr.nixon