右键运行PowerShell脚本时Copy-Item命令异常，手动执行正常求助

问题描述 #

编写了一个用于批量复制文件并应用过滤规则的PowerShell脚本，出现异常：

• 右键选择“用PowerShell运行”或双击脚本时，脚本在Copy-Item命令处崩溃
• 手动打开空白PowerShell窗口，cd到脚本所在路径后执行.run.ps1则运行正常
• 两种执行方式下echo "$($pwd)"输出完全一致
• 注释掉Copy-Item相关代码后，脚本可正常运行

脚本代码如下：

if($null -eq $env:DEVROOT) {
    echo "Error: Please configure Windows environment-variable DEVROOT 
to the root-folder of your projects."
    pause
    return
}

$devRootPath = "$env:DEVROOT"

$copyExcludes = ".git",".svn",".idea",".vscode"
$destinationPath = "code-temp-store\"
Get-ChildItem "$($devRootPath)\lma\" | Where-Object{$_.Name -notin $copyExcludes} | 
Copy-Item -Destination $destinationPath -Recurse -Force

解决办法 #

1. 捕获错误信息，定位崩溃原因 #

双击或右键运行脚本时窗口会自动关闭，无法看到具体错误。可以在脚本中添加错误捕获逻辑，让窗口停住并显示错误详情：

$ErrorActionPreference = "Stop"
try {
    if($null -eq $env:DEVROOT) {
        echo "Error: Please configure Windows environment-variable DEVROOT to the root-folder of your projects."
        pause
        return
    }

    $devRootPath = "$env:DEVROOT"

    $copyExcludes = ".git",".svn",".idea",".vscode"
    $destinationPath = "code-temp-store\"
    Get-ChildItem "$($devRootPath)\lma\" | Where-Object{$_.Name -notin $copyExcludes} | 
    Copy-Item -Destination $destinationPath -Recurse -Force
} catch {
    Write-Host "详细错误信息:`n$_" -ForegroundColor Red
    pause
}

运行后就能看到具体的错误提示，比如权限不足、路径不存在、文件被占用等。

2. 检查PowerShell执行环境的位数差异 #

Windows默认双击或右键运行的可能是32位PowerShell，而手动打开的是64位版本，两者对某些路径的访问权限或系统资源的处理不同。可以在脚本中添加环境信息输出：

Write-Host "PowerShell版本: $($PSVersionTable.PSVersion)"
Write-Host "是否64位进程: $([Environment]::Is64BitProcess)"
pause

如果两种执行方式的位数不一致，右键选择“用PowerShell (x64)运行”即可解决。

3. 使用绝对路径替代相对路径 #

虽然$pwd输出一致，但Copy-Item在不同启动场景下对相对路径的解析可能存在细微差异。将目标路径改为绝对路径：

$destinationPath = Join-Path -Path $PWD.Path -ChildPath "code-temp-store\"

确保目标路径的解析完全明确，避免相对路径带来的问题。

4. 用robocopy替代Copy-Item实现批量复制 #

PowerShell的Copy-Item在处理大量文件或复杂目录结构时可能出现稳定性问题，而Windows自带的robocopy工具更适合批量复制场景，且错误处理更完善：

if($null -eq $env:DEVROOT) {
    echo "Error: Please configure Windows environment-variable DEVROOT to the root-folder of your projects."
    pause
    return
}

$devRootPath = "$env:DEVROOT"
$sourcePath = Join-Path -Path $devRootPath -ChildPath "lma\"
$destinationPath = Join-Path -Path $PWD.Path -ChildPath "code-temp-store\"
$copyExcludes = ".git",".svn",".idea",".vscode"

# 使用robocopy执行复制，/E复制子目录（含空目录），/XD排除指定目录
robocopy $sourcePath $destinationPath /E /XD $copyExcludes /COPYALL /R:3 /W:5

# 检查robocopy退出码，0和1表示复制成功（1是有文件复制，0是无文件需要复制）
if ($LASTEXITCODE -ge 2) {
    Write-Host "复制过程中出现错误，退出码: $LASTEXITCODE" -ForegroundColor Red
    pause
}

robocopy的参数说明：

• /E: 复制所有子目录，包括空目录
• /XD: 排除指定的目录
• /COPYALL: 复制所有文件属性（包括权限、时间戳等）
• /R:3: 复制失败时重试3次
• /W:5: 重试间隔5秒

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