PowerShell批量重命名含非法字符文件时找不到文件报错求解

原代码核心错误点 #

• 路径拼接逻辑错误：递归处理子目录时直接拼接根路径和子目录全路径，生成无效路径，导致找不到目标文件
• 文件名提取错误：直接将FileInfo对象强转为字符串作为新文件名，会误带上完整路径，而Rename-Item的-NewName参数仅接收纯文件名，传入带路径的值会触发找不到文件的报错
• 无效递归：已经通过Get-ChildItem -Recurse获取了所有层级的文件，后续再递归调用函数属于重复操作，还会触发路径重复扫描的问题
• 字符替换错误：代码中使用HTML转义后的</>，无法匹配文件名中真实的</>字符，且不必要的替换了\路径分隔符

修复后的可运行代码 #

function AdjustFilename {
    param (
        [String]$Path
    )

    # 统一处理路径末尾的反斜杠
    $Path = $Path.TrimEnd('\') + '\'

    # 一次性获取所有层级的文件，不需要额外递归
    $fileList = Get-ChildItem -LiteralPath $Path -Recurse -File
    # 非法字符列表，可根据需求自行增减
    $invalidChars = @('?', '/', '<', '>', '|', ':', '*', '"', '{', '}')
    foreach ($file in $fileList) {
        # 仅处理文件名部分，不涉及路径
        $newFileName = $file.Name
        foreach ($char in $invalidChars) {
            $newFileName = $newFileName.Replace($char, '')
        }
        # 去除前后空格避免隐藏问题
        $newFileName = $newFileName.Trim()

        # 仅当文件名实际发生变化时才执行重命名
        if ($file.Name -ne $newFileName) {
            Rename-Item -LiteralPath $file.FullName -NewName $newFileName -ErrorAction SilentlyContinue
            # 可选：开启下方注释输出重命名日志方便排查
            # Write-Host "已重命名文件：$($file.FullName) -> $newFileName"
        }
    }

    # 可选：开启下方注释即可同时清理目录名的非法字符，倒序处理避免上层目录改名后下层路径失效
    <#
    $dirList = Get-ChildItem -LiteralPath $Path -Recurse -Directory | Sort-Object FullName -Descending
    foreach ($dir in $dirList) {
        $newDirName = $dir.Name
        foreach ($char in $invalidChars) {
            $newDirName = $newDirName.Replace($char, '')
        }
        $newDirName = $newDirName.Trim()
        if ($dir.Name -ne $newDirName) {
            Rename-Item -LiteralPath $dir.FullName -NewName $newDirName -ErrorAction SilentlyContinue
            # Write-Host "已重命名目录：$($dir.FullName) -> $newDirName"
        }
    }
    #>
}

AdjustFilename "C:\Temp\"

额外注意事项 #

• 如果存在重命名冲突（多个文件改名后同名），可以在替换逻辑中添加序号后缀避免报错
• 运行前建议先注释掉Rename-Item行，仅打印日志确认修改符合预期后再执行实际重命名操作

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