PowerShell移动文件保留目录结构并重命名现有文件脚本调试

问题根源 #

原脚本的核心问题是直接将源文件的文件名拼接到目标根目录路径下，完全忽略了源文件在源目录中的子目录结构。要保留目录结构，必须先还原源文件的相对路径，再在目标目录下重建对应结构。

修改后的脚本 #

$sourceDir = "E:\Folder1"
$targetDir = "W:\Folder1"

# 遍历源目录下所有文件（跳过目录，只处理文件）
Get-ChildItem -Path $sourceDir -Recurse -File | ForEach-Object {
    # 计算当前文件相对于源目录的相对路径
    $relativePath = $_.FullName.Substring($sourceDir.Length + 1)
    # 拆分相对路径，得到目标子目录路径和文件名
    $targetSubDir = Join-Path -Path $targetDir -ChildPath (Split-Path -Path $relativePath -Parent)
    $originalFileName = $_.Name

    # 如果目标子目录不存在，先创建
    if (-not (Test-Path -Path $targetSubDir)) {
        New-Item -Path $targetSubDir -ItemType Directory -Force | Out-Null
    }

    $num = 1
    # 初始化目标文件路径（先使用原文件名）
    $nextName = Join-Path -Path $targetSubDir -ChildPath $originalFileName

    # 检查目标路径是否存在，存在则递增重命名
    while (Test-Path -Path $nextName) {
        $nextName = Join-Path -Path $targetSubDir -ChildPath "$($_.BaseName)_$num$($_.Extension)"
        $num++
    }

    # 移动文件到最终目标路径
    $_ | Move-Item -Destination $nextName -Verbose
}

关键修改点说明 #

• 获取相对路径：通过$_.FullName.Substring($sourceDir.Length + 1)提取源文件相对于$sourceDir的路径，比如源文件是E:\Folder1\Subdir\file.txt，相对路径就是Subdir\file.txt。
• 重建目标子目录：用Split-Path拆分相对路径得到子目录部分，再用New-Item创建不存在的目录，确保结构一致。
• 重命名逻辑本地化：将重命名检查的范围从目标根目录改为对应子目录，避免不同子目录下的同名文件误重命名。
• 仅处理文件：添加-File参数跳过目录，避免移动目录时的冲突（目录重命名逻辑需单独处理，这里聚焦文件）。

注意事项 #

• 确保对源目录和目标目录有足够的读写权限。
• -Force参数用于创建目录时自动创建多级父目录，无需手动逐级创建。
• 如果需要保留源文件（复制而非移动），将Move-Item替换为Copy-Item即可。

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