PowerShell遍历子文件夹移动含指定文本Excel文件代码失效排查

代码存在3个核心错误，导致无法正常运行：

• 匹配逻辑完全偏离需求：目标是查找文件名包含指定文本的Excel文件，但代码用Get-Content读取xlsx文件内容做匹配。xlsx是zip格式的二进制压缩文件，直接读取会得到乱码，既匹配不到目标内容，还可能触发文件占用、编码报错。
• 遍历逻辑冗余：先单独取根目录下的子文件夹再递归遍历文件，完全可以直接从根目录递归检索，不需要额外套一层循环。
• 缺少异常处理：没有判断目标文件夹是否存在，也没有处理不同子文件夹下同名Excel的冲突问题，运行时很容易报错中断。

$RootFolder = "C:\Users\files"
$TextToFind = 'text'
$DestinationDirectory = 'C:\Users\move_here'

# 目标文件夹不存在时自动创建
if (-not (Test-Path $DestinationDirectory -PathType Container)) {
    New-Item $DestinationDirectory -ItemType Directory -Force | Out-Null
}

# 递归检索所有xlsx文件，匹配文件名后移动，自动处理同名冲突
Get-ChildItem -Path $RootFolder -Filter '*.xlsx' -File -Recurse |
    Where-Object { $_.Name -match $TextToFind } |
    ForEach-Object {
        $destPath = Join-Path $DestinationDirectory $_.Name
        $index = 1
        # 同名文件自动追加数字后缀，避免覆盖
        while (Test-Path $destPath) {
            $newName = "{0}_{1}{2}" -f $_.BaseName, $index, $_.Extension
            $destPath = Join-Path $DestinationDirectory $newName
            $index++
        }
        Move-Item $_.FullName $destPath -Force
    }

• 如果需要调整匹配规则，比如文件名必须以指定文本开头，把Where-Object里的判断改成$_.Name -like "$TextToFind*"即可。
• 如果只需要遍历根目录下第一层子文件夹，把Get-ChildItem的-Recurse参数去掉即可。

注意：不要直接用Get-Content读取xlsx文件做内容匹配，二进制格式的文件无法通过该命令正常读取文本内容，会出现大量乱码和匹配失效问题。如果实际需求是匹配Excel单元格内容而非文件名，需要先安装ImportExcel模块，通过模块提供的命令读取单元格内容后再做匹配。

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