为何PowerShell脚本运行时遗漏第二个CSV重命名，调试单步执行正常？

核心诱因推测 #

直接运行脚本时遗漏第二个CSV文件，但ISE单步执行正常，大概率是文件枚举逻辑的动态集合变更或IO操作竞态导致：

• 若脚本未提前缓存所有CSV文件路径，而是在循环中动态扫描目录，第一个文件重命名为.txt后，后续的目录扫描会因文件类型变更出现枚举异常；
• 直接运行时脚本执行速度快，IO操作（读取CSV、生成拆分文件、重命名）的竞态导致第二个文件未被纳入处理队列。

修复方案 #

1. 提前缓存所有目标CSV文件 #

先一次性获取脚本目录下所有CSV文件的完整路径，存入变量后再遍历，彻底避免动态目录扫描的问题：

# 提前缓存脚本目录下所有CSV文件，避免动态扫描带来的枚举异常
$csvFiles = Get-ChildItem -Path $PSScriptRoot -Filter *.csv -File

foreach ($file in $csvFiles) {
    # 按"Submission ID"列拆分CSV
    $csvData = Import-Csv -Path $file.FullName
    $csvData | Group-Object -Property "Submission ID" | ForEach-Object {
        $outputPath = Join-Path -Path $PSScriptRoot -ChildPath "$($_.Name).csv"
        $_.Group | Export-Csv -Path $outputPath -NoTypeInformation -Encoding UTF8
    }

    # 重命名原文件为带时间戳的TXT
    $timestamp = Get-Date -Format "yyyyMMddHHmmss"
    $newName = "$($file.BaseName)_$timestamp.txt"
    $newPath = Join-Path -Path $PSScriptRoot -ChildPath $newName
    Rename-Item -Path $file.FullName -Destination $newPath -Force
}

2. 确保IO操作原子性 #

直接运行时IO速度可能跟不上脚本执行节奏，可使用.NET的File.Move替代PowerShell原生的Rename-Item，确保重命名操作的原子性：

# 替换原Rename-Item命令
[System.IO.File]::Move($file.FullName, $newPath)

3. 捕获隐式错误 #

直接运行脚本时默认不会显示非终止错误，可在脚本开头添加错误捕获逻辑，排查是否有隐藏错误导致循环中断：

# 强制终止错误触发脚本中断，便于排查问题
$ErrorActionPreference = "Stop"

foreach ($file in $csvFiles) {
    try {
        # 拆分CSV的代码
        $csvData = Import-Csv -Path $file.FullName
        $csvData | Group-Object -Property "Submission ID" | ForEach-Object {
            $outputPath = Join-Path -Path $PSScriptRoot -ChildPath "$($_.Name).csv"
            $_.Group | Export-Csv -Path $outputPath -NoTypeInformation -Encoding UTF8
        }

        # 重命名代码
        $timestamp = Get-Date -Format "yyyyMMddHHmmss"
        $newName = "$($file.BaseName)_$timestamp.txt"
        $newPath = Join-Path -Path $PSScriptRoot -ChildPath $newName
        [System.IO.File]::Move($file.FullName, $newPath)
    }
    catch {
        Write-Error "处理文件 $($file.Name) 失败: $_"
        # 继续处理下一个文件
        continue
    }
}

验证步骤 #

1. 在脚本目录下放2个及以上测试CSV文件；
2. 直接双击运行脚本，检查所有CSV是否都被重命名为带时间戳的.txt文件；
3. 若问题仍存在，打开PowerShell控制台，切换到脚本目录手动执行.\你的脚本名.ps1，查看控制台输出的错误信息定位问题。

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