使用Compress-Archive生成无效Zip文件的技术问题排查

核心原因 #

你的问题主要由以下几点导致：

1. 旧版PowerShell的Compress-Archive兼容性bug
   PowerShell 5.1及更早版本的Compress-Archive cmdlet，在处理包含大量嵌套文件、特殊属性文件（如系统文件、隐藏文件）或符号链接的文件夹时，容易出现压缩不完整、压缩包格式损坏的问题。你生成的zip仅1MB远小于手动压缩的34MB，说明大部分文件未被正确压缩进包内——这种不完整的zip能被兼容性更强的7zip识别，但Windows资源管理器和Expand-Archive对zip格式校验更严格，因此无法打开。

2. 路径拼接的潜在风险
   手动用$Source +'\*'拼接路径，若$Source本身末尾带有反斜杠，会生成\\*的无效路径片段，可能导致部分文件被跳过。虽然PowerShell通常能容错，但复杂文件夹场景下可能触发异常。

3. 特殊文件处理缺失
   .NET或InTouch项目文件夹中可能包含符号链接、长路径文件（超过260字符），Compress-Archive默认不会解析符号链接（仅压缩链接本身而非目标文件），对长路径文件的支持也有限，这会导致压缩内容缺失，进而损坏压缩包结构。

解决方案 #

1. 修复路径拼接逻辑 #

用Join-Path替代手动拼接，避免路径格式错误：

function Zip-Folder { 
    Write-Host  "Start Compressing $ProjectName at $Source"
    $compress = @{
        Path = Join-Path -Path $Source -ChildPath '*'
        CompressionLevel = "fastest"
        DestinationPath = Join-Path -Path (Get-Item $Source).Parent.FullName -ChildPath "$ProjectName.zip"
    }    
    Compress-Archive @compress -Force
    Write-Host  "Finished Compressing $ProjectName"      
}

2. 升级PowerShell版本 #

PowerShell 7+彻底重构了Compress-Archive的底层实现，修复了大量旧版本的兼容性bug，对长路径、特殊文件的支持更完善。升级后再执行压缩操作，大概率能解决格式不兼容问题。

3. 改用.NET ZipArchive类（更可靠） #

如果必须使用旧版PowerShell，建议直接调用.NET的ZipArchive类来压缩，兼容性和稳定性更强：

function Zip-Folder {
    Write-Host "Start Compressing $ProjectName at $Source"
    $zipPath = Join-Path -Path (Get-Item $Source).Parent.FullName -ChildPath "$ProjectName.zip"
    # 确保目标文件被覆盖
    if (Test-Path $zipPath) { Remove-Item $zipPath -Force }
    # 加载必要程序集
    Add-Type -AssemblyName System.IO.Compression.FileSystem
    # 创建ZipArchive
    $zipFile = [System.IO.File]::Create($zipPath)
    $zipArchive = [System.IO.Compression.ZipArchive]::new($zipFile, [System.IO.Compression.ZipArchiveMode]::Create)
    # 递归添加所有文件
    Get-ChildItem -Path $Source -Recurse -File | ForEach-Object {
        $relativePath = $_.FullName.Substring($Source.Length + 1)
        $zipEntry = $zipArchive.CreateEntry($relativePath, [System.IO.Compression.CompressionLevel]::Fastest)
        $fileStream = $_.OpenRead()
        $zipStream = $zipEntry.Open()
        $fileStream.CopyTo($zipStream)
        $zipStream.Close()
        $fileStream.Close()
    }
    # 清理资源
    $zipArchive.Dispose()
    $zipFile.Close()
    Write-Host "Finished Compressing $ProjectName"
}

4. 调用7zip命令行（兼容所有场景） #

如果你已经安装了7zip，可以直接调用其命令行工具，完全避免PowerShell自带cmdlet的问题：

function Zip-Folder {
    Write-Host "Start Compressing $ProjectName at $Source"
    $zipPath = Join-Path -Path (Get-Item $Source).Parent.FullName -ChildPath "$ProjectName.zip"
    # 7zip默认安装路径，若你的路径不同请修改
    $7zipPath = "C:\Program Files\7-Zip\7z.exe"
    # 执行压缩命令，-mx1对应fastest压缩级别
    & $7zipPath a -tzip -mx1 -y $zipPath "$Source\*"
    Write-Host "Finished Compressing $ProjectName"
}

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