Jak porównać foldery w .NET – Przewodnik z GroupDocs
Jeśli potrzebujesz wiedzieć jak porównać foldery w .NET, jesteś we właściwym miejscu. W tym samouczku przeprowadzimy Cię przez użycie GroupDocs.Comparison do automatycznego wykrywania różnic między dwoma katalogami, generowania zarówno logów TXT, jak i bogatych raportów HTML oraz integracji procesu w rzeczywistych aplikacjach C#.
Szybkie odpowiedzi
- Jaki jest główny cel? Automatyzacja porównywania folderów i generowanie szczegółowych raportów TXT lub HTML.
- Jakie formaty wyjściowe są obsługiwane? TXT do łatwego parsowania i HTML do generowania wizualnego raportu.
- Czy potrzebuję licencji? Bezpłatna wersja próbna wystarczy do nauki; licencja komercyjna usuwa znaki wodne w produkcji.
- Czy mogę uruchomić to na Linuxie? Tak – GroupDocs.Comparison obsługuje .NET Core na Linux, macOS i Windows.
- Jakie wersje .NET są kompatybilne? .NET Core 3.1+ oraz .NET 5/6/7/8.
Czego nauczysz się w tym przewodniku?
W tym przewodniku nauczysz się, jak porównać dwa katalogi w C# przy użyciu GroupDocs.Comparison, generować zarówno raporty TXT, jak i HTML, efektywnie obsługiwać duże struktury folderów oraz integrować porównywanie w pipeline’ach CI/CD lub skryptach weryfikacji kopii zapasowych. Odkryjesz także, jak dostroić wydajność przy masywnych zestawach danych i dostosować układ raportu HTML do własnych potrzeb.
Dlaczego porównywanie folderów ma znaczenie dla programistów .NET
Porównywanie folderów oszczędza czas ręcznego przeglądania setek plików. Niezależnie od tego, czy weryfikujesz wdrożenia, sprawdzasz kopie zapasowe, czy śledzisz dryf konfiguracji, compare directories C# pozwala w ciągu kilku sekund wykryć dodane, usunięte lub zmodyfikowane pliki zamiast godzin ręcznej pracy.
Wymagania wstępne i konfiguracja środowiska
Zanim przejdziemy do praktycznej części, upewnijmy się, że masz wszystko, czego potrzebujesz. Nie martw się – konfiguracja jest prosta, a ja przeprowadzę Cię przez każdy krok.
Czego będziesz potrzebować
Wymagane biblioteki i wersje
- GroupDocs.Comparison for .NET: Version 25.4.0 (the latest stable release as of 2025) – supports 50+ input and output formats including DOCX, PDF, HTML, and image types.
- .NET Framework/SDK: Compatible with .NET Core 3.1+ and .NET 5/6/7/8
- Development Environment: Visual Studio 2019+ (Community edition works perfectly)
Wymagania wiedzy
- Podstawowa znajomość programowania w C# (jeśli potrafisz napisać prostą aplikację konsolową, jesteś gotowy)
- Znajomość operacji na systemie plików w .NET (praca ze ścieżkami, katalogami, plikami)
- Rozumienie zarządzania pakietami NuGet
Szybka kontrola środowiska
- Otwórz ulubione IDE (Visual Studio, VS Code lub JetBrains Rider)
- Utwórz nową aplikację konsolową targetującą .NET Core 3.1 lub nowszy
- Upewnij się, że masz dostęp do NuGet Package Manager
Jeśli potrafisz wykonać te trzy rzeczy, jesteś gotowy! Teraz zainstaluj i skonfiguruj GroupDocs.Comparison.
Instalacja i konfiguracja GroupDocs.Comparison
Uruchomienie GroupDocs.Comparison w Twoim projekcie to pestka. Masz dwie główne metody instalacji i pokażę Ci obie.
Metody instalacji
Opcja 1: NuGet Package Manager Console (Recommended for Visual Studio users)
Install-Package GroupDocs.Comparison -Version 25.4.0
Opcja 2: .NET CLI (Perfect for command‑line enthusiasts)
dotnet add package GroupDocs.Comparison --version 25.4.0
Pro tip: Always specify the version to ensure consistency across your team and deployment environments.
Zrozumienie opcji licencjonowania
GroupDocs.Comparison oferuje elastyczne licencjonowanie dopasowane do różnych potrzeb:
- Free Trial: Perfect for evaluation – gives you access to all features with some limitations
- Temporary License: Ideal for proof‑of‑concept projects – removes trial restrictions temporarily
- Commercial License: Full features for production applications
Do celów edukacyjnych wersja próbna jest w zupełności wystarczająca. W razie potrzeby możesz później przejść na wersję płatną.
Podstawowa inicjalizacja i konfiguracja
Oto Twój pierwszy fragment kodu GroupDocs.Comparison. Ta prosta konfiguracja weryfikuje, czy wszystko działa poprawnie:
using System;
using GroupDocs.Comparison;
class Program
{
static void Main()
{
// Initialize the license if available
License license = new License();
// license.SetLicense("Path to your license file"); // Uncomment when you have a license
Console.WriteLine("GroupDocs.Comparison for .NET is ready to use.");
Console.WriteLine("Let's start comparing some folders!");
}
}
Jeśli kod uruchomi się bez błędów, gratulacje! Jesteś gotowy, aby budować potężną funkcjonalność porównywania folderów.
Jak porównać foldery i zapisać wyniki jako pliki TXT
Zacznijmy od najprostszej metody: porównania dwóch katalogów i zapisania wyników w pliku tekstowym. To podejście jest idealne dla skryptów automatycznych, systemów logowania lub gdy potrzebny jest prosty, łatwy do parsowania format wyjściowy.
Dlaczego wybrać format TXT?
Pliki tekstowe są niezwykle wszechstronne. Są lekkie, łatwe do programowego parsowania, przyjazne dla kontroli wersji i mogą być wyświetlane na dowolnym systemie. Idealne do:
- Automatycznych procesów budowania
- Analizy plików logów
- Narzędzi wiersza poleceń
- Integracji z innymi systemami
Implementacja krok po kroku
Krok 1: Skonfiguruj opcje porównania
Kotwica definicji: FolderComparisonOptions definiuje wszystkie konfigurowalne ustawienia operacji porównania folderów.
using System;
using System.IO;
using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;
string sourceFolder = "YOUR_DOCUMENT_DIRECTORY/SOURCE_FOLDER";
string targetFolder = "YOUR_DOCUMENT_DIRECTORY/TARGET_FOLDER";
string outputDirectory = "YOUR_OUTPUT_DIRECTORY";
// Set comparison options for TXT output
Options.CompareOptions compareOptionsTxt = new Options.CompareOptions
{
DirectoryCompare = true,
FolderComparisonExtension = GroupDocs.Comparison.Options.FolderComparisonExtension.Txt
};
Informujesz GroupDocs.Comparison, że chcesz porównać całe katalogi (nie pojedyncze pliki) i wyjść w formacie tekstowym. Ustawienie DirectoryCompare = true jest kluczowe – włącza rekurencyjne porównywanie katalogów.
Krok 2: Zainicjalizuj obiekt Comparer
Kotwica definicji: Comparer jest podstawową klasą wykonującą porównanie między elementami źródłowymi i docelowymi.
Comparer comparerTxt = new Comparer(sourceFolder, compareOptionsTxt);
// Add target folder for comparison
comparerTxt.Add(targetFolder, compareOptionsTxt);
Tutaj zaczyna się magia. Tworzysz instancję Comparer z folderem źródłowym jako bazą, a następnie dodajesz folder docelowy do porównania. To jak powiedzenie „porównaj wszystko w folderze B z folderem A”.
Krok 3: Wykonaj porównanie i zapisz wyniki
string txtOutputFileName = Path.Combine(outputDirectory, "ComparisonResult.txt");
comparerTxt.Compare(txtOutputFileName, compareOptionsTxt);
Console.WriteLine("TXT file with comparison results saved successfully.");
Console.WriteLine($"Check your results at: {txtOutputFileName}");
Gotowe! Wyniki porównania są zapisane w pliku tekstowym. Wyjście zawiera szczegóły o dodanych, usuniętych i zmodyfikowanych plikach, co ułatwia zrozumienie zmian między dwoma katalogami.
Zrozumienie formatu wyjścia TXT
Wygenerowany plik tekstowy zazwyczaj zawiera:
- Added files – present in the target but not in the source
- Deleted files – present in the source but not in the target
- Modified files – exist in both directories but have different content
- File metadata – size, modification dates, and other relevant information
Jak porównać foldery i zapisać wyniki jako pliki HTML
Podczas gdy pliki TXT świetnie sprawdzają się w automatyzacji, wyjście HTML błyszczy, gdy potrzebny jest wizualny, przyjazny dla człowieka raport. Raporty HTML są idealne do przeglądów kodu, prezentacji dla klientów lub udostępniania wyników osobom nietechnicznym.
Korzyści z wyjścia HTML (i jak generować raport HTML)
- Visual diff highlighting – see exactly what changed with color‑coded differences
- Interactive navigation – click through files and folders easily
- Professional presentation – ideal for reports and documentation
- Cross‑platform viewing – opens in any web browser
Krok 1: Skonfiguruj opcje porównania HTML
Kotwica definicji: FolderComparisonExtension.Html tells the API to produce an HTML‑based report instead of plain text.
// Set comparison options for HTML output
Options.CompareOptions compareOptionsHtml = new Options.CompareOptions
{
DirectoryCompare = true,
FolderComparisonExtension = GroupDocs.Comparison.Options.FolderComparisonExtension.Html
};
Kluczowa różnica to ustawienie FolderComparisonExtension.Html, które instruuje GroupDocs.Comparison, aby wygenerował bogaty raport HTML zamiast zwykłego tekstu.
Krok 2: Zainicjalizuj Comparer dla wyjścia HTML
Comparer comparerHtml = new Comparer(sourceFolder, compareOptionsHtml);
// Add target folder to the comparison
comparerHtml.Add(targetFolder, compareOptionsHtml);
Ten sam wzorzec co wcześniej, ale skonfigurowany do wyjścia HTML. Spójność API GroupDocs.Comparison pozwala używać tych samych metod niezależnie od formatu wyjściowego.
Krok 3: Wygeneruj i zapisz raport HTML
string htmlOutputFileName = Path.Combine(outputDirectory, "ComparisonResult.html");
comparerHtml.Compare(htmlOutputFileName, compareOptionsHtml);
Console.WriteLine("HTML file with comparison results saved successfully.");
Console.WriteLine($"Open in browser: {htmlOutputFileName}");
Otrzymany plik HTML jest kompletnym, samodzielnym raportem, który możesz otworzyć w dowolnej przeglądarce. Zawiera elementy interaktywne, podświetlanie składni (dla plików kodu) oraz czysty, profesjonalny układ.
Czego oczekiwać w raporcie HTML
- Summary dashboard – overview of total changes, files affected, and comparison statistics
- Side‑by‑side comparisons – visual diff view showing exactly what changed
- Folder tree navigation – easy browsing through the directory structure
- File‑level details – individual file comparisons with highlighted differences
Typowe przypadki użycia i zastosowania w rzeczywistym świecie
Zrozumienie, kiedy i jak używać porównywania folderów, może znacząco usprawnić Twój przepływ pracy. Oto scenariusze, w których ta funkcjonalność okazuje się nieoceniona:
Przegląd kodu i kontrola wersji
Scenario: You’re reviewing changes between two branches or comparing different versions of your codebase.
Why folder comparison helps: Instead of checking files one by one, you can instantly see all modifications, additions, and deletions across your entire project structure. The HTML output is particularly useful here—you can share visual diff reports with your team.
Weryfikacja kopii zapasowych
Scenario: You need to verify that your backup process correctly copied all files and that no corruption occurred.
Implementation tip: Use TXT output for automated verification scripts that can be integrated into your backup workflow. Set up alerts when discrepancies are detected.
Zarządzanie konfiguracją w różnych środowiskach
Scenario: You’re managing application configurations across development, staging, and production environments.
Best practice: Regular folder comparisons help catch configuration drift before it causes production issues. HTML reports are perfect for change‑management documentation.
Kontrola wersji dokumentów
Scenario: You’re managing document repositories where multiple team members make changes to files.
Pro tip: Combine folder comparison with scheduled tasks to automatically generate change reports. This is especially useful for compliance and audit purposes.
Integracja z pipeline CI/CD
Scenario: You want to automatically detect and report changes as part of your deployment process.
Advanced usage: Integrate folder comparison into your build pipeline to generate change reports for each deployment, helping with rollback decisions and change tracking.
Optymalizacja wydajności i najlepsze praktyki
Przy pracy z dużymi strukturami katalogów wydajność staje się kluczowa. Oto sprawdzone strategie, które pomogą utrzymać porównywanie folderów w płynnej formie:
Strategie optymalizacji
Smart Directory Selection
- Compare only the directories you actually need to analyze
- Use filters to exclude temporary files, logs, or other irrelevant content
- Consider splitting very large comparisons into smaller, focused chunks
Memory Management
Kotwica definicji: Comparer.Dispose() releases all unmanaged resources held by the comparer, preventing memory leaks.
// Dispose of comparer objects properly
using (Comparer comparer = new Comparer(sourceFolder, compareOptions))
{
comparer.Add(targetFolder, compareOptions);
comparer.Compare(outputFileName, compareOptions);
} // Automatically disposed here
- Asynchronous Processing
For large comparisons, consider implementing async patterns to prevent UI blocking in desktop applications or timeout issues in web applications.
Wskazówki monitorowania wydajności
- Monitor memory usage during large comparisons
- Track processing time for different directory sizes
- Set realistic expectations for users based on directory complexity
- Consider progress reporting for long‑running operations
Rozwiązywanie typowych problemów
Nawet przy dobrze napisanym kodzie możesz napotkać pewne wyzwania. Oto najczęstsze problemy i ich rozwiązania:
Problemy z dostępem do plików i uprawnieniami
Problem: “Access denied” or “file in use” errors
Solution:
- Ensure your application runs with appropriate permissions
- Check that files aren’t locked by other processes
- Implement retry logic for temporary file locks
Problemy ze ścieżkami i katalogami
Problem: Invalid path errors or directory not found
Solution:
// Always validate paths before comparison
if (!Directory.Exists(sourceFolder))
{
throw new DirectoryNotFoundException($"Source directory not found: {sourceFolder}");
}
if (!Directory.Exists(targetFolder))
{
throw new DirectoryNotFoundException($"Target directory not found: {targetFolder}");
}
Problemy z pamięcią i wydajnością
Problem: Out of memory exceptions or slow performance
Solutions:
- Break large comparisons into smaller batches
- Exclude unnecessary file types from comparison
- Monitor and optimize memory usage patterns
Problemy z generowaniem plików wyjściowych
Problem: Output files not generated or corrupted
Troubleshooting steps:
- Verify write permissions in the output directory
- Ensure sufficient disk space
- Check for invalid characters in file paths
- Validate output directory exists before comparison
Zaawansowane opcje konfiguracji
GroupDocs.Comparison oferuje liczne opcje konfiguracyjne, które pozwalają precyzyjnie dostosować zachowanie porównania:
Ustawienia czułości porównania
Możesz regulować, jak wrażliwe jest porównanie na różne typy zmian:
- Whitespace handling – ignore or include whitespace changes
- Case sensitivity – control whether case differences are considered changes
- Line ending normalization – handle different line ending formats
Filtrowanie typów plików
Skup swoje porównania na konkretnych typach plików:
compareOptions.FileAuthorMetadata = false; // Ignore metadata changes
compareOptions.GenerateFramePreview = true; // Generate preview frames
Niestandardowe formatowanie wyjścia
Dostosuj format wyjścia do własnych potrzeb:
- Custom templates – modify HTML output styling
- Metadata inclusion – control what file information is included
- Diff granularity – choose between file‑level or line‑level comparisons
Podsumowanie i dalsze kroki
Gratulacje! Opanowałeś podstawy porównywania folderów przy użyciu GroupDocs.Comparison dla .NET. Teraz potrafisz:
✅ Skonfigurować i uruchomić GroupDocs.Comparison w swoich projektach
✅ Porównać katalogi i generować zarówno raporty TXT, jak i HTML (w tym generate HTML report)
✅ Radzić sobie z typowymi wyzwaniami i optymalizować wydajność
✅ Zintegrować porównywanie folderów w rzeczywistych aplikacjach
Co dalej?
Gotowy, aby podnieść umiejętności porównywania folderów na wyższy poziom? Rozważ:
- Advanced filtering options for more targeted comparisons
- API integration for web‑based comparison services
- Batch processing for handling multiple directory pairs
- Custom reporting formats tailored to your organisation’s needs
Zacznij wdrażać już dziś
Najlepszy sposób na opanowanie tych koncepcji to praktyka. Wybierz jeden ze swoich aktualnych projektów i zidentyfikuj, gdzie porównywanie folderów może usprawnić Twój przepływ pracy. Zacznij od małych kroków, eksperymentuj z różnymi formatami wyjściowymi i stopniowo wprowadzaj bardziej zaawansowane funkcje.
Pamiętaj: każdy ekspert kiedyś zaczynał jako początkujący. Daj sobie czas, eksperymentuj swobodnie i nie wahaj się sięgać po ten przewodnik, gdy potrzebujesz odświeżenia!
Najczęściej zadawane pytania
Q: Can I use GroupDocs.Comparison for .NET on Linux systems?
A: Absolutely! GroupDocs.Comparison fully supports cross‑platform deployment through .NET Core. It works seamlessly on Linux, macOS, and Windows environments.
Q: How should I handle very large directories with thousands of files?
A: For large directories, implement these strategies: use asynchronous processing, break comparisons into smaller batches, exclude unnecessary file types, and monitor memory usage. Consider providing progress feedback to users for long‑running operations.
Q: Is there a practical limit to the number of files I can compare?
A: While there’s no hard limit built into the library, performance depends on your system resources (RAM, CPU, disk speed) and file sizes. Most systems can handle thousands of files without issues, but very large datasets might require optimisation strategies.
Q: Can GroupDocs.Comparison handle encrypted or password‑protected files?
A: The library cannot directly compare encrypted files. You’ll need to decrypt files first if you have the appropriate permissions and credentials. Always ensure you comply with your organisation’s security policies when handling encrypted content.
Q: How do I integrate folder comparison into automated CI/CD pipelines?
A: Create console applications that use GroupDocs.Comparison, configure them to return appropriate exit codes based on comparison results, and integrate them into your build scripts. TXT output is particularly useful for parsing results in automated environments.
Q: What’s the difference between trial and licensed versions?
A: The trial version includes all functionality but adds watermarks to output and has some usage limitations. Licensed versions remove these restrictions and are suitable for production use.
Q: Can I customize the HTML output styling and layout?
A: Yes, GroupDocs.Comparison provides options to customize HTML output. You can modify templates, adjust styling, and control what information is included in the reports.
Q: How do I handle files that exist in one directory but not the other?
A: GroupDocs.Comparison automatically identifies and reports these differences as “added” or “deleted” files. You can configure how these differences are presented in your output format.
Dodatkowe zasoby i wsparcie
Dokumentacja
- Complete API Reference: GroupDocs.Comparison .NET API Documentation
- Developer Guide: GroupDocs Developer Resources
Pobieranie i licencjonowanie
- Latest Release: Download GroupDocs.Comparison
- Purchase Options: Buy Commercial License
- Free Trial: Start Your Free Trial
- Temporary License: Request Evaluation License
Last Updated: 2026-07-20
Tested With: GroupDocs.Comparison 25.4.0 for .NET
Author: GroupDocs
