记一次 18W+ 项目依赖残留撑爆 Win10 回收站导致死机的抢救经历

#requires -Version 5.1
# Windows 10 - 清空所有本地固定磁盘及可移动磁盘的回收站
# 警告：永久删除回收站内容，不可恢复

$ErrorActionPreference = 'Continue'

# ---------- 1. 自动请求管理员权限 ----------
$identity = [Security.Principal.WindowsIdentity]::GetCurrent()
$principal = New-Object Security.Principal.WindowsPrincipal($identity)
$isAdmin = $principal.IsInRole(
    [Security.Principal.WindowsBuiltInRole]::Administrator
)

if (-not $isAdmin) {
    if (-not $PSCommandPath) {
        Write-Host "请将脚本保存为 .ps1 文件后运行。" -ForegroundColor Red
        Read-Host "按回车退出"
        exit 1
    }

    $argsList = "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`""
    try {
        Start-Process -FilePath "powershell.exe" `
            -ArgumentList $argsList -Verb RunAs
    }
    catch {
        Write-Host "无法获取管理员权限：$($_.Exception.Message)" `
            -ForegroundColor Red
        Read-Host "按回车退出"
    }
    exit
}
// [!code fold:start]
# ---------- 2. 创建日志 ----------
$logFile = Join-Path $env:TEMP (
    "RecycleBinCleanup_{0:yyyyMMdd_HHmmss}.log" -f (Get-Date)
)

function Write-Log {
    param([string]$Message)

    $line = "{0:yyyy-MM-dd HH:mm:ss} {1}" -f (Get-Date), $Message
    Write-Host $line
    Add-Content -LiteralPath $logFile -Value $line -Encoding UTF8
}

Write-Log "========== 开始清理回收站 =========="
Write-Log "日志文件：$logFile"

# ---------- 3. 获取本地固定盘和可移动盘 ----------
try {
    $drives = @(
        Get-CimInstance Win32_LogicalDisk |
        Where-Object { $_.DriveType -in @(2, 3) } |
        Sort-Object DeviceID
    )
}
catch {
    Write-Log "获取磁盘列表失败：$($_.Exception.Message)"
    Read-Host "按回车退出"
    exit 1
}

if ($drives.Count -eq 0) {
    Write-Log "没有发现可处理的本地磁盘。"
    Read-Host "按回车退出"
    exit 0
}

$success = 0
$failed = 0
$skipped = 0
$total = $drives.Count
$index = 0

# ---------- 4. 逐磁盘清理 ----------
foreach ($drive in $drives) {
    $index++
    $letter = $drive.DeviceID
    $recycleBin = Join-Path ($letter + '\') '$Recycle.Bin'

    Write-Progress `
        -Activity "清理 Windows 回收站" `
        -Status "正在处理 $letter ($index/$total)" `
        -PercentComplete (($index / $total) * 100)

    Write-Log "正在处理磁盘 $letter"

    if (-not (Test-Path -LiteralPath $recycleBin -PathType Container)) {
        Write-Log "$letter 没有回收站目录，跳过。"
        $skipped++
        continue
    }

    # 安全检查：只允许处理盘符根目录下的 $Recycle.Bin
    $expected = $letter + '\$Recycle.Bin'
    if ($recycleBin -ine $expected) {
        Write-Log "路径安全检查未通过，跳过：$recycleBin"
        $failed++
        continue
    }

    # 第一次尝试直接删除，避免不必要的全盘权限扫描
    $output = & "$env:SystemRoot\System32\cmd.exe" `
        /d /c "rd /s /q `"$recycleBin`"" 2>&1
    $exitCode = $LASTEXITCODE

    if ($exitCode -ne 0 -or
        (Test-Path -LiteralPath $recycleBin -PathType Container)) {

        Write-Log "$letter 首次清理未完成，尝试修复权限。"

        # 获取目录及其子项的所有权
        $output = & "$env:SystemRoot\System32\takeown.exe" `
            /f $recycleBin /r /d Y 2>&1
        $takeownCode = $LASTEXITCODE

        if ($takeownCode -ne 0) {
            Write-Log "$letter 获取所有权时出现错误：$($output -join ' ')"
        }

        # 向内置 Administrators 组授予完全控制权限
        $output = & "$env:SystemRoot\System32\icacls.exe" `
            $recycleBin /grant '*S-1-5-32-544:(OI)(CI)F' `
            /t /c /q 2>&1
        $aclCode = $LASTEXITCODE

        if ($aclCode -ne 0) {
            Write-Log "$letter 修改权限时出现错误：$($output -join ' ')"
        }

        # 再次尝试清理
        $output = & "$env:SystemRoot\System32\cmd.exe" `
            /d /c "rd /s /q `"$recycleBin`"" 2>&1
        $exitCode = $LASTEXITCODE
    }

    # ---------- 5. 验证结果 ----------
    if (-not (Test-Path -LiteralPath $recycleBin -PathType Container)) {
        Write-Log "$letter 回收站目录已清除。"
        $success++
    }
    else {
        Write-Log "$letter 清理未能完成，可能有文件占用或权限限制。"
        if ($output) {
            Write-Log "最后的命令输出：$($output -join ' ')"
        }
        $failed++
    }
}

Write-Progress -Activity "清理 Windows 回收站" -Completed

# ---------- 6. 输出汇总 ----------
Write-Log "========== 清理结束 =========="
Write-Log "清理成功：$success 个磁盘"
Write-Log "跳过：$skipped 个磁盘"
Write-Log "失败或未完成：$failed 个磁盘"
Write-Log "日志位置：$logFile"

Write-Host ""
Write-Host "清理任务结束。" -ForegroundColor Cyan
Write-Host "成功：$success    跳过：$skipped    失败：$failed"
Write-Host "日志：$logFile"
Write-Host "注意：Windows 通常会在以后需要时重新创建回收站目录。"
Read-Host "按回车退出"