Polskie znaki na stronie nagle zmieniają się w ciągi typu „ó” albo „Å‚”? Często winne jest nieprawidłowe kodowanie dokumentu, a deklaracja meta charset zwykle pomaga je prawidłowo odczytać, o ile zgadza się z faktycznym sposobem zapisania pliku.
Poprawna deklaracja zaczyna się od UTF-8
- Użyj:
w sekcji. - Położenie: element powinien znaleźć się w całości w pierwszych 1024 bajtach dokumentu.
- Zgodność: plik i deklaracja muszą wskazywać to samo kodowanie.
- Kontrola: nagłówek HTTP może mieć pierwszeństwo przed deklaracją w HTML.

Jedna linijka, która mówi przeglądarce, jak czytać plik
Przeglądając zasady HTML, za najważniejsze uważam rozdzielenie dwóch rzeczy: tekstu zapisanego w pliku i informacji, która mówi przeglądarce, jak odczytać jego bajty. Znacznik kodowania przekazuje tę informację, ale nie konwertuje samodzielnie zawartości pliku.
W typowym dokumencie HTML zapisanym jako UTF-8 deklaracja wygląda tak:
Przykładowa strona
Zażółć gęślą jaźń.
Atrybut charset określa kodowanie dokumentu HTML. Zgodnie ze standardem HTML WHATWG jego wartością w nowoczesnym HTML powinno być utf-8, a dokument nie powinien zawierać kilku deklaracji kodowania.
Plik i deklaracja muszą mówić tym samym językiem
Widok strony w edytorze może wyglądać poprawnie, a mimo to przeglądarka pokaże krzaki. Dzieje się tak, gdy plik zapisano w jednym kodowaniu, lecz HTML lub serwer deklaruje inne. Sama podmiana tekstu w znaczniku nie naprawi wtedy błędnie zapisanego źródła.
Przykład: treść zapisana jako Windows-1250, ale odczytywana jako UTF-8, może wyświetlać polskie litery niepoprawnie. Rozwiązaniem jest zapisanie pliku jako UTF-8 i utrzymanie zgodnej deklaracji, a nie wpisanie w znaczniku nazwy kodowania, której plik faktycznie nie używa.
Reguła decyzji jest prosta: jeśli możesz ustawić serwer, dopilnuj prawidłowego nagłówka HTTP i zgodności pliku; jeśli edytujesz sam HTML, dodaj deklarację UTF-8 na początku sekcji . Gdy nagłówek i znacznik sobie przeczą, sprawdź nagłówek odpowiedzi, bo może przesądzić o interpretacji.
Najpierw sprawdź nagłówek, potem kod źródłowy
Gdy polskie znaki się psują, zmiana znacznika na chybił trafił często tylko zaciemnia sprawę. Porównaj deklarację w HTML, kodowanie pliku i nagłówek odpowiedzi serwera, zamiast zakładać, że winna jest jedna linijka.
| Sytuacja | Możliwa przyczyna | Co zrobić |
|---|---|---|
| Polskie litery wyglądają jak „Å„” lub „ó” | Rzeczywiste kodowanie pliku różni się od tego, które przyjęła przeglądarka | Sprawdź kodowanie pliku i nagłówek HTTP, po czym ustaw zgodne UTF-8 |
Zmiana meta charset niczego nie poprawia |
Nagłówek serwera może deklarować inne kodowanie albo plik nadal jest zapisany inaczej | Sprawdź odpowiedź HTTP i ustawienia zapisu w edytorze |
Dokument ma kilka deklaracji charset |
Szablon, wtyczka lub ręcznie dodany kod powieliły znacznik | Pozostaw jedną deklarację kodowania i sprawdź, czy szablon nie generuje drugiej |
Wynik porównania rozstrzyga, gdzie leży problem: jeśli źródło jest zapisane jako UTF-8, ale serwer wysyła sprzeczny nagłówek, edycja samego HTML może nie wystarczyć. Zasady pierwszeństwa i deklarowania kodowania opisuje W3C Internationalization.
Deklarację umieść blisko początku dokumentu
Znacznik schowany głęboko w rozbudowanym nagłówku może zostać pominięty podczas wczesnego rozpoznawania kodowania. Umieść go możliwie wysoko w sekcji , przed długimi blokami stylów, skryptów czy metadanych.
Dokumentacja elementu meta na MDN podaje, że deklaracja kodowania powinna mieścić się w całości w pierwszych 1024 bajtach dokumentu. To bajty, nie liczba widocznych znaków, więc rozbudowany nagłówek przed znacznikiem może utrudnić spełnienie tego warunku.
Przy praktycznym sprawdzeniu strony kolejność jest następująca: obejrzyj początek pliku, potwierdź jego kodowanie w edytorze, a następnie sprawdź nagłówek HTTP. Jeśli te trzy elementy wskazują UTF-8, polskie znaki powinny być odczytywane spójnie; jeśli nie, popraw źródło rozbieżności zamiast dodawać kolejny znacznik.
Nie zastępuj UTF-8 starszą wartością
W starszych przykładach można spotkać kodowanie takie jak ISO-8859-2 albo zapis z http-equiv. Dla współczesnego HTML właściwym wyborem jest UTF-8; starszy wariant składni nie daje powodu, by deklarować inne kodowanie.
Krótka kontrola przed publikacją pozwala uniknąć częstej pomyłki: jedna deklaracja , plik faktycznie zapisany jako UTF-8 i brak sprzecznego nagłówka serwera. Gdy polskie znaki nadal się rozjeżdżają, szukaj różnicy między tymi ustawieniami, a nie kolejnych wariantów znacznika.