PowerShell目录结构导出脚本报错修复求助（v5.1.19041.6093）

问题原因 #

错误是由于Split-Path命令接收到空字符串作为Path参数导致的。虽然调用Get-FolderTree时传入了$rootPath.FullName，但可能存在参数意外为空的情况（比如变量未正确赋值），或者函数参数未做必填限制导致空值流入。

修复步骤 #

1. 强制path参数必填：给函数的path参数添加Mandatory=$true，确保调用时必须传入有效路径，杜绝空值。
2. 提前验证路径有效性：在执行Split-Path前先检查路径是否为空，避免无效调用。
3. 优化根目录名称提取：用.NET方法[System.IO.Path]::GetFileName($path)替代Split-Path -Leaf，它对根目录（如D:\）会返回空，但不会触发参数绑定错误，配合后续降级逻辑更可靠。

修复后的完整脚本 #

# Get the current folder
$rootPath = Get-Location
$outputFile = Join-Path $rootPath "FolderStructure.txt"

function Get-FolderTree {
    param (
        [Parameter(Mandatory=$true)]
        [string]$path,
        [int]$level = 0
    )

    $indent = " " * ($level * 4)

    if ($level -eq 0) {
        # Safe root name extraction
        if ([string]::IsNullOrWhiteSpace($path)) {
            throw "路径不能为空"
        }
        $rootName = [System.IO.Path]::GetFileName($path)
        if ([string]::IsNullOrWhiteSpace($rootName)) {
            $rootName = $path  # fallback for root drives like D:\
        }
        Add-Content -Path $outputFile -Value "$rootName\"
    }

    # Get folders
    Get-ChildItem -Path $path -Directory -Force | Sort-Object Name | ForEach-Object {
        Add-Content -Path $outputFile -Value "$indent├── $($_.Name)\"
        Get-FolderTree -path $_.FullName -level ($level + 1)
    }

    # Get files
    Get-ChildItem -Path $path -File -Force | Sort-Object Name | ForEach-Object {
        Add-Content -Path $outputFile -Value "$indent│   $($_.Name)"
    }
}

# Clear output if it already exists
if (Test-Path $outputFile) {
    Remove-Item $outputFile
}

# Run the scan
Get-FolderTree -path $rootPath.FullName
Write-Host "`n✅ Folder structure saved to: $outputFile"

关键修改说明 #

• [Parameter(Mandatory=$true)]：强制调用Get-FolderTree时必须传入path参数，从源头避免空值流入。
• 新增路径空值检查：在处理根名称前先判断$path是否为空，提前抛出明确错误。
• 替换根名称提取方法：[System.IO.Path]::GetFileName($path)功能与Split-Path -Leaf一致，但对空路径的处理更稳定，不会触发参数绑定错误。

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