PowerShell按txt首行批量重命名文件报路径非法错误排查

该报错核心是传入Rename-Item的新文件名不符合Windows文件系统命名规则，具体由原代码的三个问题导致：

• 未处理文件名非法字符：txt文件第一行内容很可能包含\ / : * ? " < > |这类Windows明确禁止出现在文件名中的字符，也可能首尾带空格、结尾带点号这类系统不支持的文件名格式，直接传入就会触发路径非法错误。
• 第一行提取逻辑有缺陷：-Head 1参数本身就只会返回文件第一行内容，额外加的[-1]索引完全冗余。如果碰到空txt文件，Get-Content返回$null，取索引后得到的值还是空，给-NewName传空值必然报错；如果碰到编码识别异常的文件，Get-Content将第一行拆分为单字符数组返回，[-1]只会拿到第一行的最后一个字符，完全不符合重命名预期。
• 未保留文件扩展名：直接用第一行内容当新文件名，没有补.txt后缀，重命名后文件会丢失扩展名，后续无法被txt筛选规则识别。

另外原代码没有加-File参数，遍历过程中可能匹配到同名txt目录触发异常，也没有处理重名文件场景，碰到同名文件会直接触发覆盖报错。

# 一次性枚举所有待处理txt文件，加-File参数排除目录，避免重命名过程中重复枚举已处理文件
Get-ChildItem -Filter *.txt -File | ForEach-Object {
    # 指定UTF8编码读取第一行，减少中文乱码问题
    $firstLine = Get-Content -Path $_.FullName -Head 1 -Encoding UTF8
    # 空文件、第一行全是空白字符的文件直接跳过
    if ([string]::IsNullOrWhiteSpace($firstLine)) {
        Write-Host "跳过无有效第一行内容的文件：$($_.Name)"
        return
    }
    # 自动替换所有非法文件名字符为下划线，清理首尾空格、结尾非法点号
    $invalidChars = [System.IO.Path]::GetInvalidFileNameChars()
    $cleanName = [string]::Join('_', $firstLine.Split($invalidChars)).Trim().TrimEnd('.')
    # 补全txt扩展名
    $newName = "$cleanName.txt"
    $targetPath = Join-Path -Path $_.DirectoryName -ChildPath $newName
    # 重名文件自动加序号，避免覆盖
    $dupCount = 1
    while (Test-Path -Path $targetPath) {
        $newName = "${cleanName}_${dupCount}.txt"
        $targetPath = Join-Path -Path $_.DirectoryName -ChildPath $newName
        $dupCount++
    }
    # 执行重命名
    Rename-Item -Path $_.FullName -NewName $newName
}

• 增加-File参数，确保只处理文件，不会误匹配同名目录
• 提前固定待处理文件列表，避免重命名后的新文件被循环再次捕获，导致重复处理
• 移除冗余的[-1]索引，指定编码读取减少乱码，增加空内容跳过逻辑
• 自动清理所有文件名非法字符，处理首尾空格、结尾点号等不符合命名规则的内容
• 自动补全.txt扩展名，保留文件格式
• 增加重名自动序号逻辑，避免同名文件覆盖报错

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