萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

C# 呼叫 WinRAR 命令列實現壓縮/解壓縮:無視窗、密碼、分卷、多執行緒完整參數指南

前言

在 .NET 應用程式中呼叫 WinRAR.exe 執行壓縮/解壓縮,是無需第三方庫即可支援 RAR/ZIP/7z 等格式的實用技巧。本文提供完整 Process 呼叫封裝、參數詳細說明、無視窗/無彈窗設定、進度監控、錯誤處理與安全性建議。

一、核心封裝類別

using System;
using System.Diagnostics;
using System.IO;

public static class WinRarWrapper
{
    private static string ExePath => Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "WinRAR.exe");

    public static ProcessResult Compress(CompressOptions opt)
    {
        string args = BuildCompressArgs(opt);
        return Run(args, opt.TimeoutMs);
    }

    public static ProcessResult Extract(ExtractOptions opt)
    {
        string args = BuildExtractArgs(opt);
        return Run(args, opt.TimeoutMs);
    }

    private static string BuildCompressArgs(CompressOptions o)
    {
        // a -as -r -afzip -ed -hp{password} -ibck -inul -m{level} -mt{threads} {archive} {sources...}
        var parts = new System.Text.StringBuilder();
        parts.Append("a ");                    // 添加檔案到壓縮檔
        if (o.SyncArchive) parts.Append("-as ");          // 同步壓縮檔內容 (刪除來源已不存在的檔案)
        if (o.Recursive) parts.Append("-r ");             // 遞迴子目錄
        parts.Append($"-af{o.Format} ");                  // 格式: zip, rar, 7z 等
        if (o.ExcludeEmptyDirs) parts.Append("-ed ");     // 不加入空目錄
        if (!string.IsNullOrEmpty(o.Password)) parts.Append($"-hp{o.Password} "); // 加密 (AES-256)
        parts.Append("-ibck ");                          // 背景執行 (無視窗)
        parts.Append("-inul ");                          // 禁止錯誤訊息彈窗
        parts.Append($"-m{(int)o.CompressionLevel} ");   // 0=存儲 1=最快 ... 5=最佳
        if (o.Threads > 0) parts.Append($"-mt{o.Threads} "); // 多執行緒 (1-32)
        if (o.AutoRename) parts.Append("-or ");           // 自動重命名衝突檔案
        parts.Append($"\\"{o.ArchivePath}\\" ");            // 目的壓縮檔路徑 (加引號)
        foreach (var src in o.SourcePaths)
            parts.Append($"\\"{src}\\" "");                // 來源檔案/資料夾 (加引號)

        return parts.ToString().Trim();
    }

    private static string BuildExtractArgs(ExtractOptions o)
    {
        // x -hp{password} -ibck -inul -y -mt{threads} {archive} {destPath}
        var parts = new System.Text.StringBuilder();
        parts.Append("x ");                              // 解壓縮完整路徑
        if (!string.IsNullOrEmpty(o.Password)) parts.Append($"-hp{o.Password} ");
        parts.Append("-ibck -inul -y ");                 // 背景、無彈窗、全選是
        if (o.Threads > 0) parts.Append($"-mt{o.Threads} ");
        parts.Append($"\\"{o.ArchivePath}\\" ");
        if (!string.IsNullOrEmpty(o.DestPath))
            parts.Append($"\\"{o.DestPath}\\" ");

        return parts.ToString().Trim();
    }

    private static ProcessResult Run(string args, int timeoutMs)
    {
        if (!File.Exists(ExePath))
            return new ProcessResult { Success = false, Error = $"找不到 WinRAR.exe: {ExePath}" };

        var psi = new ProcessStartInfo
        {
            FileName = ExePath,
            Arguments = args,
            CreateNoWindow = true,
            UseShellExecute = false,
            RedirectStandardOutput = true,
            RedirectStandardError = true,
            WindowStyle = ProcessWindowStyle.Hidden
        };

        using (var proc = Process.Start(psi))
        {
            string stdout = proc.StandardOutput.ReadToEnd();
            string stderr = proc.StandardError.ReadToEnd();

            bool exited = proc.WaitForExit(timeoutMs);
            if (!exited)
            {
                try { proc.Kill(); } catch { }
                return new ProcessResult { Success = false, Error = "逾時終止", StdOut = stdout, StdErr = stderr };
            }

            return new ProcessResult
            {
                Success = proc.ExitCode == 0,
                ExitCode = proc.ExitCode,
                StdOut = stdout,
                StdErr = stderr,
                Error = proc.ExitCode != 0 ? stderr : null
            };
        }
    }
}

public class CompressOptions
{
    public string ArchivePath { get; set; }
    public string[] SourcePaths { get; set; }
    public string Format = "zip"; // zip, rar, 7z
    public int CompressionLevel = 5; // 0-5
    public int Threads = 4;
    public bool Recursive = true;
    public bool SyncArchive = false;
    public bool ExcludeEmptyDirs = true;
    public bool AutoRename = true;
    public string Password = null;
    public int TimeoutMs = 300_000; // 5 分鐘
}

public class ExtractOptions
{
    public string ArchivePath { get; set; }
    public string DestPath { get; set; }
    public string Password = null;
    public int Threads = 4;
    public int TimeoutMs = 300_000;
}

public class ProcessResult
{
    public bool Success { get; set; }
    public int ExitCode { get; set; }
    public string StdOut { get; set; }
    public string StdErr { get; set; }
    public string Error { get; set; }
}

二、WinRAR 命令列參數完整對照表

參數說明範例
a添加檔案到壓縮檔a archive.zip file.txt
x解壓縮並保留完整路徑x archive.zip
e解壓縮但忽略路徑 (全部平鋪)e archive.zip
-af<fmt>指定格式: zip, rar, 7z, tar, gz...-afzip
-as同步壓縮檔內容 (刪除來源已刪除的檔案)
-r遞迴子目錄
-ed不加入空目錄
-hp[pwd]加密 (AES-256),密碼直接接在後面無空格-hpMySecret123
-ibck背景模式 (無視窗、無工作列圖示)
-inul禁止所有錯誤訊息彈窗
-m<0-5>壓縮等級: 0=存儲, 3=標準(預設), 5=最佳-m5
-mt<N>執行緒數 1-32 (預設 1)-mt4
-or自動重命名衝突檔案
-y所有提示自動選「是」
-v<size>分卷大小 (如 -v100m、-v1g)-v50m
-ep1排除基底目錄路徑 (相對路徑存入)
-rr[N]添加恢復記錄 (N% 或預設)-rr3

三、使用範例

// 壓縮整個資料夾為 ZIP,最高壓縮、4 執行緒、加密
var compressResult = WinRarWrapper.Compress(new CompressOptions
{
    ArchivePath = @"D:\Backups\Project_v1.zip",
    SourcePaths = new[] { @"D:\Projects\MyProject" },
    Format = "zip",
    CompressionLevel = 5,
    Threads = 4,
    Password = "StrongP@ssw0rd",
    Recursive = true
});

if (!compressResult.Success)
    Console.WriteLine($"壓縮失敗: {compressResult.Error}");

// 解壓縮
var extractResult = WinRarWrapper.Extract(new ExtractOptions
{
    ArchivePath = @"D:\Backups\Project_v1.zip",
    DestPath = @"D:\Restore\Project_v1",
    Password = "StrongP@ssw0rd",
    Threads = 4
});

四、關鍵部署細節

  1. WinRAR.exe 部署:將 WinRAR.exe (及 Rar.exe、UnRAR.dll) 放在應用程式根目錄或指定路徑,並設定 `ExePath`。注意授權:商業用途需購買 WinRAR 授權。
  2. 32/64 位元相容:WinRAR 提供 32/64 位元版本,建議隨應用程式部署 64 位元版,或偵測 `Environment.Is64BitProcess` 動態選擇。
  3. 非同步包裝:Web/API 環境請用 `Task.Run(() => WinRarWrapper.Compress(...))` 避免阻塞請求執行緒。
  4. 安全性:來源路徑、密碼等參數經過驗證/清理,防止命令注入 (雖然 `ProcessStartInfo` 使用 `Arguments` 字串而非 Shell 執行,風險較低)。

五、純 .NET 替代方案 (無外部相依)

  • Zip:System.IO.Compression.ZipFile (標準庫)、SharpZipLib、DotNetZip。
  • RAR 解壓:SevenZipSharp (包裝 7z.dll)、NAR (純 C# RAR 解壓)。
  • 7z / 多格式:SevenZipSharp 或直接呼叫 7z.exe (LGPL、免費、支援 RAR 解壓)。

純 managed 方案部署簡單、跨平台 (Linux Docker)、無授權疑慮,建議優先評估。

copyright © 萬盛學電腦網 all rights reserved