PowerShell 基于文件列表搜索并复制文件的脚本修改与原理解析

你原有脚本无法实现复制功能的核心原因是：执行$folderFiles = (Get-ChildItem -Recurse $folder -File).Name 时，只把搜索到的文件名转成了纯字符串数组，丢失了每个文件对应的完整路径、系统文件对象信息，而Copy-Item 命令需要明确的文件路径或文件对象作为输入，仅凭纯文件名无法定位文件位置完成复制。
具体调整步骤：

• 不要提前把全量搜索结果转成纯文件名字符串数组，改为保留完整的FileInfo文件对象集合，保存每个文件的完整路径、所在位置等元数据
• 在循环匹配文件名时，从完整文件对象集合中定位匹配项，直接将匹配到的文件对象传给复制命令即可

调整后的可直接运行代码：

# 开始搜索的父目录
$searchRoot = 'C:\Workspace\discovery-jumpstart\src'
# 存放缺失文件清单的文本目录
$listDir = 'C:\Workspace\discovery-jumpstart'
# 读取需要匹配的文件清单
$requiredFiles = Get-Content $listDir\MISSING_BMS.txt
# 定义文件复制目标目录（不存在则自动创建）
$copyTarget = 'C:\Workspace\Collected_Matched_Files'
if (-not (Test-Path $copyTarget)) {
    New-Item -ItemType Directory -Path $copyTarget | Out-Null
}

# 存储搜索目录下所有文件的完整对象信息，不做纯文件名转换
$allFilesInSearch = Get-ChildItem -Recurse $searchRoot -File

foreach ($targetName in $requiredFiles) {
    # 匹配文件名一致的文件对象
    $matchedFile = $allFilesInSearch | Where-Object Name -eq $targetName
    if ($matchedFile) {
        Write-Host "文件 $targetName 已找到" -ForegroundColor Green
        # 直接将匹配到的文件传入复制命令完成操作
        $matchedFile | Copy-Item -Destination $copyTarget
    }
    else {
        Write-Host "文件 $targetName 未找到！" -ForegroundColor Red
    }
}

注意：如果搜索范围内存在多个重名文件，当前逻辑会将所有匹配的重名文件全部复制到目标目录，若要避免重名覆盖，可根据需求在Copy-Item中添加重命名规则

你找到的脚本可直接实现复制功能，核心是依靠PowerShell的管道流传递完整文件对象，跳过了纯字符串存储的步骤，逐环节运行逻辑如下：

• 原脚本存在一处小语法瑕疵：$file_source ="C:\Results_Found_Files_Scan.txt' 首尾引号不匹配（前为双引号、后为单引号），会直接触发运行报错，你手动修正引号后才能正常执行
• 第一步Get-Content $file_source：逐行读取存放待匹配文件名的文本文件，将每一行的文件名作为输入值送入后续管道
• 第二步ForEach-Object { Get-ChildItem -Path $source -Recurse -Filter "$_" }：对每一个从文本中读取的文件名（PowerShell中$_代表当前管道传入的单个对象），递归遍历指定搜索目录，通过-Filter参数匹配同名文件，将匹配到的完整文件对象（包含完整路径、元数据）向下游传递
• 第三步Copy-Item -Destination $target：直接接收上游管道传递的所有文件对象，自动读取每个文件的完整源路径，将文件复制到指定目标目录，无需手动拼接文件路径

该脚本和你原有脚本的核心差异是：全程没有将搜索结果转成纯字符串的文件名数组，而是沿着管道直接传递可被命令直接识别的文件对象，减少了手动存储路径、拼接路径的冗余逻辑。

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