在 .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; }
}
| 參數 | 說明 | 範例 |
|---|---|---|
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
});
WinRAR.exe (及 Rar.exe、UnRAR.dll) 放在應用程式根目錄或指定路徑,並設定 `ExePath`。注意授權:商業用途需購買 WinRAR 授權。System.IO.Compression.ZipFile (標準庫)、SharpZipLib、DotNetZip。7z.exe (LGPL、免費、支援 RAR 解壓)。純 managed 方案部署簡單、跨平台 (Linux Docker)、無授權疑慮,建議優先評估。