PowerShell变量保留上一轮迭代值引发异常行为

我编写了一个PowerShell脚本，用于遍历目录并根据每个目录内to-delete.filter文件定义的过滤器删除文件。脚本在有过滤器文件的文件夹中运行正常，但遇到无过滤器文件的文件夹时，会错误使用上一个文件夹的过滤器。

目录结构 #

.
├── 1-unimportant-folder
│   ├── garbage.txt
│   └── to-delete.filter  # 内容：*.*
├── 2-important-folder
│   ├── important-file-1.txt
│   └── important-script.py
├── 3-script-folder
│   ├── 1.log
│   └── to-delete.filter  # 内容：*.log
└── cleaner.ps1

原脚本代码 #

$folders = Get-ChildItem -Directory
foreach($folder in $folders){
    Write-Host "Processing folder: $($folder.FullName)"

    $toDeleteFilterPath = Join-Path -Path $folder.FullName -ChildPath "to-delete.filter"

    # 检查过滤器文件并准备删除路径
    if (Test-Path -Path $toDeleteFilterPath) {
        $deleteFilter = Get-Content -Path $toDeleteFilterPath
    }

    # 其他业务代码
    # ...


    # 如果识别到过滤器，执行删除
    if ($deleteFilter) {
        $pathToRemove = Join-Path -Path $folder.FullName -ChildPath $deleteFilter
        Write-Host "Found items to delete based on filter: $pathToRemove" -ForegroundColor Yellow
        Remove-Item -Path $pathToRemove -WhatIf
    }
}

预期与实际问题 #

• 预期行为：脚本应针对1-unimportant-folder和3-script-folder使用各自的过滤器生成WhatIf输出，2-important-folder因无to-delete.filter文件应被完全跳过（该迭代中$deleteFilter应为null）。
• 实际问题：处理完1-unimportant-folder后，处理2-important-folder时会复用之前的*.*过滤器，尝试删除该文件夹内所有内容，异常输出如下：

Processing folder: /path/to/1-unimportant-folder
Found items to delete based on filter: /path/to/1-unimportant-folder/*.*
What if: Performing the operation "Remove File" on target "/path/to/1-unimportant-folder/garbage.txt".
What if: Performing the operation "Remove File" on target "/path/to/1-unimportant-folder/to-delete.filter".

Processing folder: /path/to/2-important-folder
Found items to delete based on filter: /path/to/1-unimportant-folder/*.*  <-- 问题所在
What if: Performing the operation "Remove File" on target "/path/to/2-important-folder/important-file-1.txt".
What if: Performing the operation "Remove File" on target "/path/to/2-important-folder/important-script.py".

Processing folder: /path/to/3-script-folder
Found items to delete based on filter: /path/to/3-script-folder/*.log
What if: Performing the operation "Remove File" on target "/path/to/3-script-folder/1.log".
What if: Performing the operation "Remove File" on target "/path/to/3-script-folder/to-delete.filter".

解决方案 #

问题根源是$deleteFilter变量在循环中没有被重置，导致没有过滤器文件的文件夹会保留上一次循环的过滤器值。只需在每次循环开始时将$deleteFilter置为$null即可解决：

修改后的脚本 #

$folders = Get-ChildItem -Directory
foreach($folder in $folders){
    # 每次循环初始化过滤器变量，避免复用旧值
    $deleteFilter = $null
    Write-Host "Processing folder: $($folder.FullName)"

    $toDeleteFilterPath = Join-Path -Path $folder.FullName -ChildPath "to-delete.filter"

    # 检查过滤器文件并准备删除路径
    if (Test-Path -Path $toDeleteFilterPath) {
        $deleteFilter = Get-Content -Path $toDeleteFilterPath
    }

    # 其他业务代码
    # ...


    # 如果识别到过滤器，执行删除
    if ($deleteFilter) {
        $pathToRemove = Join-Path -Path $folder.FullName -ChildPath $deleteFilter
        Write-Host "Found items to delete based on filter: $pathToRemove" -ForegroundColor Yellow
        Remove-Item -Path $pathToRemove -WhatIf
    }
}

原理说明 #

在foreach循环的开头添加$deleteFilter = $null，确保每次处理新文件夹时，过滤器变量都从空值开始。当文件夹不存在to-delete.filter文件时，$deleteFilter保持$null，后续的删除逻辑就不会被触发，从而避免误删无过滤器文件夹内的内容。

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