Formatowanie XML

Czym jest formatowanie XML i po co go używać?

<!-- Minified XML input -->
<?xml version="1.0" encoding="UTF-8"?><catalog><product id="p01"><name>Wireless Headphones</name><price currency="USD">79.99</price></product></catalog>

<!-- After formatting with 2-space indent -->
<?xml version="1.0" encoding="UTF-8"?>
<catalog>
  <product id="p01">
    <name>Wireless Headphones</name>
    <price currency="USD">79.99</price>
  </product>
</catalog>

Kluczowe funkcje

Przykłady

<?xml version="1.0" encoding="UTF-8"?><catalog><product id="p01" category="electronics"><name>Wireless Headphones</name><price currency="USD">79.99</price><stock>142</stock><tags><tag>audio</tag><tag>bluetooth</tag></tags></product><product id="p02" category="books"><name>Learning XML</name><price currency="USD">29.99</price><stock>55</stock></product></catalog>

<rss version="2.0"><channel><title>Go Tools Blog</title><link>https://go-tools.org/blog</link><description>Developer tools, tips and tutorials</description><item><title>Understanding XML Namespaces</title><link>https://go-tools.org/blog/xml-namespaces-guide</link><pubDate>Thu, 29 May 2026 00:00:00 GMT</pubDate><description>A deep dive into XML namespace declarations, prefixes, and scope rules with practical examples.</description></item><item><title>XML vs JSON: When to Use Each</title><link>https://go-tools.org/blog/xml-vs-json</link><pubDate>Mon, 25 May 2026 00:00:00 GMT</pubDate></item></channel></rss>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><soap:Header><wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><wsse:UsernameToken><wsse:Username>api-client</wsse:Username><wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-ext-1.0.xsd#PasswordText">s3cr3t</wsse:Password></wsse:UsernameToken></wsse:Security></soap:Header><soap:Body><GetOrderRequest xmlns="http://example.com/orders"><OrderId>ORD-20260529-001</OrderId><IncludeLineItems>true</IncludeLineItems></GetOrderRequest></soap:Body></soap:Envelope>

Jak używać

1. 1

   Wklej dane XML

   Wprowadź lub wklej XML do pola wejściowego powyżej. Możesz też kliknąć «Wczytaj przykład», aby wypróbować próbkę (zminimalizowany katalog produktów XML, który ładnie się formatuje).

2. 2

   Wybierz akcję

   Kliknij Formatuj, aby upiększyć z wcięciami, Minimalizuj, aby usunąć białe znaki, lub Waliduj, aby sprawdzić poprawność strukturalną. Przed formatowaniem wybierz wcięcie 2 lub 4 spacje.

3. 3

   Skopiuj wynik

   Przetworzony XML pojawia się w panelu wyjściowym. Kliknij Kopiuj, aby przenieść go do schowka. Jeśli Walidacja wykryła błędy, baner błędu pokazuje dokładny numer wiersza i kolumny.

Typowe błędy XML

<products>
  <Item>
    <name>Widget</name>
  </item>
</products>

<products>
  <item>
    <name>Widget</name>
  </item>
</products>

<query>price > 10 & stock > 0</query>

<query>price &gt; 10 &amp; stock &gt; 0</query>

<product id=p01 label="It's a "widget"">

<product id="p01" label="It's a &quot;widget&quot;">

<user><name>Alice</name></user>
<user><name>Bob</name></user>

<users>
  <user><name>Alice</name></user>
  <user><name>Bob</name></user>
</users>

<?xml version="1.0" encoding="UTF-8"?>
<!-- File is actually saved as UTF-16 -->

<?xml version="1.0" encoding="UTF-16"?>
<!-- File saved as UTF-16, declaration matches -->

<script><![CDATA[
  if (a < b && b > c) { return true; }
<!-- ]]> is missing -->

<script><![CDATA[
  if (a < b && b > c) { return true; }
]]></script>

Typowe zastosowania

Debugowanie ładunków SOAP i usług webowych

Odpowiedzi SOAP z korporacyjnych API i starszych usług webowych przychodzą jako jednolinijkowe ciągi XML. Wklej surowy ładunek do formatowania, aby natychmiast zobaczyć strukturę koperty, nagłówki i treść — co ułatwia znalezienie szukanego pola lub wykrycie niezgodności przestrzeni nazw. Patrz też: Konwerter XML na JSON, jeśli potrzebujesz dalej przetwarzać ładunek w JavaScript.

Walidacja plików konfiguracyjnych i deskryptorów wdrożeń

Pliki Maven POM, konteksty aplikacji Spring XML, server.xml Tomcat, pliki Android Manifest i wiele innych plików konfiguracyjnych Java/enterprise to XML. Uruchom je przez Waliduj przed zatwierdzeniem, aby wykryć niezgodne znaczniki lub problemy z kodowaniem, które w innym przypadku ujawniłyby się dopiero podczas kompilacji lub wdrożenia.

Formatowanie wyjścia kanałów RSS i Atom

Kanały RSS 2.0 i Atom 1.0 to XML. Przy tworzeniu generatora kanałów lub debugowaniu problemów ze zgodnością czytnika kanałów, sformatuj surowy XML kanału, aby inspekcjonować metadane kanału, strukturę elementów i wymagane deklaracje przestrzeni nazw obok siebie.

Czytanie i edycja plików SVG

Pliki SVG wyeksportowane z Figmy, Illustratora lub Sketcha są prawidłowym XML, ale często są zminimalizowane lub zawierają nadmierne wcięcia z eksportera. Sformatuj SVG, aby uzyskać czystą, nawigowaną hierarchię elementów przed ręcznymi edycjami ścieżek, grup lub atrybutów stylizacji.

Przygotowanie XML do przechowywania lub przesyłania

Przy przechowywaniu XML w kolumnie bazy danych, wysyłaniu go jako pole ciągu JSON w żądaniu API lub wstawianiu do kolejki komunikatów, użyj najpierw Minimalizuj, aby usunąć zbędne białe znaki. Zmniejsza to rozmiar ładunku i unika problemów z parserami JSON, które mogą się krzaczyć na nieescapowanych znakach kontrolnych w dużych wcięciowych ciągach XML.

Konwersja XML na JSON

Jeśli chcesz przekonwertować sformatowany XML na JSON do użycia w aplikacji JavaScript lub REST API, skorzystaj z naszego Konwertera XML na JSON. Do odwrotnego kierunku — budowania XML ze struktury JSON — użyj Konwertera JSON na XML.

Szczegóły techniczne

DOMParser przeglądarki do parsowania XML

Parsowanie XML używa natywnego DOMParser przeglądarki z typem MIME «text/xml». Jest to ten sam silnik, który obsługuje renderowanie SVG i XHTML w przeglądarce — jest w pełni zgodny z XML 1.0 i raportuje błędy poprawności strukturalnej z informacją o numerze wiersza i kolumny. Gdy dokument nie jest poprawny strukturalnie, DOMParser zwraca dokument parsererror zawierający komunikat błędu i pozycję, które narzędzie wyodrębnia i wyświetla.

Serializacja drzewa DOM do formatowania

Formatowanie działa przez parsowanie XML do drzewa DOM, a następnie rekurencyjne przechodzenie po drzewie w celu produkowania wciętego wyjścia. To podejście zachowuje semantyczną strukturę dokumentu: zagnieżdżenie elementów, treść tekstową, atrybuty, sekcje CDATA, instrukcje przetwarzania i komentarze są wszystkie serializowane dokładnie tak jak zostały sparsowane. Odrzucane są wyłącznie węzły tekstowe zawierające tylko białe znaki między elementami — węzły tekstowe zawierające znaki inne niż białe są zawsze zachowywane.

Minimalizacja przez usuwanie węzłów tekstowych zawierających tylko białe znaki

Minimalizacja przechodzi przez to samo drzewo DOM i usuwa węzły tekstowe, których zawartość składa się wyłącznie z białych znaków (spacje, tabulatory, znaki nowej linii). Węzły tekstowe z mieszaną lub niebiałą zawartością — faktyczne dane między znacznikami — nigdy nie są usuwane. Atrybuty i ich wartości są serializowane bez dodatkowych białych znaków. Wynikiem jest najbardziej zwarta poprawna strukturalnie reprezentacja XML oryginalnego dokumentu.

100% w przeglądarce — bez przesyłania, bez serwera

Całe przetwarzanie odbywa się w środowisku uruchomieniowym JavaScript przeglądarki. Żadne dane nie są przesyłane na żaden serwer w żadnym momencie. Jest to szczególnie ważne w przypadku ładunków XML, które często zawierają wrażliwe treści: tokeny SOAP WS-Security, dane pacjentów HL7, wewnętrzną konfigurację serwisów oraz finansowe formaty wiadomości (FIX, SWIFT ISO 20022). Narzędzie jest bezpieczne do użytku z dowolnym XML, którego nie chciałbyś wklejać do publicznej usługi.

Dobre praktyki

Waliduj przed formatowaniem, formatuj przed zatwierdzaniem

Najpierw zwaliduj XML, aby potwierdzić jego poprawność strukturalną przed ponownym formatowaniem — formatowanie może po cichu produkować nieprawidłowe wyjście, jeśli dane wejściowe nie są poprawnym XML. Po walidacji sformatuj i przejrzyj wcięte wyjście przed zatwierdzeniem plików konfiguracyjnych, szablonów kanałów lub definicji WSDL w systemie kontroli wersji.

Używaj wcięcia 2-spacjowego dla formatów webowych, 4-spacjowego dla korporacyjnego XML

Wcięcie 2-spacjowe jest konwencją dla kanałów RSS/Atom, SVG, XHTML, XML Androida i większości XML zorientowanego na web. Wcięcie 4-spacjowe jest powszechne w środowiskach Java enterprise (Maven POM, pliki kontekstu Spring, deskryptory wdrożeń JBoss). Dopasuj konwencję do istniejących plików i łańcucha narzędzi.

Minimalizuj XML przed osadzaniem w JSON

Jeśli chcesz osadzić ciąg XML jako wartość pola JSON, zawsze najpierw go minimalizuj. Wcięty XML zawiera znaki nowej linii i wielokrotne spacje, które muszą być escapowane w JSON (\n, wielokrotne \u0020), znacznie zwiększając rozmiar ładunku. Zminimalizowany XML jest też znacznie mniej podatny na wywoływanie ograniczeń długości linii w pośrednich proxy lub systemach rejestrowania.

Escapuj znaki specjalne w treści tekstowej, używaj CDATA oszczędnie

Dla krótkich wartości tekstowych zawierających & lub <, używaj referencji encji (&, <) — są bardziej przenośne niż sekcje CDATA i działają też w wartościach atrybutów. Rezerwuj sekcje CDATA () dla osadzania dużych bloków kodu, zapytań SQL lub fragmentów HTML, gdzie escapowanie każdego znaku specjalnego uczyniłoby treść nieczytelną.

Deklaruj przestrzenie nazw jak najwcześniej

Deklaruj przestrzenie nazw XML (xmlns:prefix="URI") na elemencie głównym lub na elemencie najwyższego poziomu, który używa prefiksu. Deklarowanie przestrzeni nazw głęboko w drzewie dokumentu utrudnia czytanie XML i może powodować problemy z parserami XML opartymi na strumieniu (SAX, StAX), które przetwarzają przestrzenie nazw inkrementalnie. Przykład koperty SOAP powyżej demonstruje zalecany wzorzec: wszystkie deklaracje przestrzeni nazw na elemencie głównym Envelope.

Najczęściej zadawane pytania