Jak otworzyć plik JSON i co oznacza rozszerzenie .json?
Plik JSON to tekstowy format wymiany danych opisany w RFC 8259 przez RFC Editor w 2017 roku; zapisuje informacje jako pary klucz-wartość i tablice. Zamiast specjalnego programu często wystarczy Notatnik, ale Visual Studio Code, Microsoft Excel z Power Query i Notepad++ znacznie ułatwiają odczyt dużych eksportów oraz wykrywanie błędów.
JSON nie jest programem ani plikiem wykonywalnym JavaScript. Nazwa pochodzi od JavaScript Object Notation, lecz format może przenosić dane między aplikacjami napisanymi w różnych językach. Spotkasz go podczas eksportu ustawień, pobierania kopii kontaktów, pracy z danymi API, konfiguracją gry czy raportem analitycznym.
Czym jest JSON jako format danych?
JSON to zwykły plik tekstowy, charakteryzujący się nazwami pól, przypisanymi wartościami i nawiasami określającymi strukturę danych.
Najprostszy przykład wygląda tak:
„Parafraza RFC 8259: JSON jest lekkim, tekstowym i niezależnym od języka programowania formatem wymiany danych.” - RFC Editor, RFC 8259, 2017
W pliku może znaleźć się na przykład nazwa użytkownika, data utworzenia konta albo lista produktów. Komputer odczyta strukturę nawet wtedy, gdy cały plik mieści się w jednej bardzo długiej linii. Człowiek zwykle potrzebuje formatowania JSON.
- Eksport kontaktów - aplikacja może zapisać imię, numer telefonu i adres e-mail każdego kontaktu jako osobne pola.
- Plik konfiguracyjny - gra lub program może przechowywać ustawienia języka, dźwięku i ścieżki folderów.
- Dane API - serwis internetowy może zwracać JSON z ceną produktu, stanem magazynowym i identyfikatorem zamówienia.
- Kopia ustawień - rozszerzenie przeglądarki może wyeksportować listę reguł do pliku .json.
- Raport analityczny - system sprzedażowy może przekazać rekordy klientów, faktur i dat w jednej strukturze.
Z mojej praktyki przy eksportach z programów użytkowych wynika, że sam odczyt jest prosty, a problem zaczyna się dopiero przy edycji lub imporcie zagnieżdżonych danych. Przed zmianą czegokolwiek skopiuj oryginał do innego folderu.
Jak rozpoznać prawdziwy plik JSON?
Plik z rozszerzeniem .json powinien po otwarciu zawierać tekst zaczynający się zwykle od nawiasu klamrowego { albo kwadratowego [, ale samo rozszerzenie nie potwierdza poprawności ani bezpieczeństwa.
W Eksploratorze plików Windows włącz widoczność rozszerzeń: Widok > Pokaż > Rozszerzenia nazw plików. Dzięki temu zauważysz plik nazwany na przykład ustawienia.json.exe, który nie jest dokumentem JSON, lecz programem. Nie uruchamiaj go.
- Nazwa pliku - rozszerzenie powinno kończyć się dokładnie na .json, a nie na .json.txt lub .json.exe.
- Ikona i właściwości - po kliknięciu prawym przyciskiem wybierz Właściwości i sprawdź typ pliku oraz źródło pobrania.
- Zawartość tekstowa - otwórz kopię w Notatniku i sprawdź, czy widzisz znaki tekstu, a nie losowe symbole binarne.
- Rozmiar pliku - plik o wielkości kilku megabajtów może być normalnym eksportem, ale duży rozmiar utrudnia otwarcie w prostym edytorze.
- Pochodzenie - plik otrzymany od nieznanej osoby lub z reklamy „pobierz teraz” traktuj ostrożnie, nawet gdy ma poprawne rozszerzenie.
Więcej o tym, jak system rozpoznaje typ dokumentu, wyjaśnia artykuł rozszerzenia plików - kompletny przewodnik.
Czym otworzyć plik JSON w Windows i macOS?
Plik JSON otworzysz w Windows przez kliknięcie prawym przyciskiem myszy i wybór Otwórz za pomocą; do szybkiego podglądu użyj Notatnika, a do bezpiecznej pracy z formatowaniem wybierz Visual Studio Code. Na macOS analogiczną rolę prostego podglądu pełni TextEdit ustawiony na zwykły tekst.
Nie zmieniaj programu domyślnego na siłę, jeśli JSON otwierasz tylko raz. Wybierz aplikację jednorazowo, obejrzyj zawartość i zamknij plik bez zapisywania. To ogranicza ryzyko przypadkowego nadpisania eksportu.
Czy plik JSON można otworzyć w Notatniku lub przeglądarce?
Tak, Notatnik otworzy JSON jako tekst, lecz nie naprawi błędów ani nie zamieni jednej długiej linii w czytelną strukturę.
- Windows - kliknij plik prawym przyciskiem myszy i wybierz Otwórz za pomocą, a następnie Notatnik.
- macOS - kliknij plik z klawiszem Control, wybierz Otwórz w programie i wskaż TextEdit.
- TextEdit - przed edycją wybierz Format > Zamień na zwykły tekst, aby dokument nie został zapisany jako RTF.
- Przeglądarka - przeciągnij wyłącznie niepoufny plik do otwartej karty Chrome, Edge lub Firefox, aby uzyskać szybki podgląd.
- Zapis - jeśli edytor zapyta o kodowanie, wybierz UTF-8 i zachowaj kopię pod nową nazwą, na przykład ustawienia-test.json.
Przeglądarka zwykle pokaże tekst, ale nie zastąpi edytora JSON. Przy pliku z 20 000 rekordów przewijanie karty będzie męczące, a przy danych prywatnych lepiej nie korzystać z usług sieciowych.
Jakie programy do otwierania JSON wybrać?
Do zwykłego odczytu wystarczy Notatnik, do ręcznej edycji lepszy jest Notepad++ lub Visual Studio Code, a Microsoft Excel służy głównie do importu rekordów podobnych do tabeli.
| Program | Najlepsze zastosowanie | Formatowanie i błędy | Ryzyko przy edycji |
|---|---|---|---|
| Notatnik | Szybki podgląd małego pliku | Brak wygodnej walidacji | Łatwo przypadkiem zapisać plik jako TXT |
| Notepad++ | Prosta edycja w Windows | Podświetlanie składni i wtyczki | Nie każda wtyczka jest potrzebna lub godna zaufania |
| Visual Studio Code | Formatowanie, walidacja i duże pliki | Wbudowana obsługa JSON | Nie instaluj przypadkowych rozszerzeń z reklam |
| Microsoft Excel | Analiza tabelarycznych rekordów | Import przez Power Query | Zagnieżdżenia mogą zmienić układ danych |
Jeżeli chcesz jedynie przeczytać ustawienie „language”: „pl”, Notatnik wystarczy. Gdy musisz znaleźć brakujący przecinek w konfiguracji Home Assistant, dodatku do gry albo aplikacji firmowej, wybieram Visual Studio Code. Szybciej pokazuje miejsce błędu.
Jak sformatować JSON w Visual Studio Code?
W Visual Studio Code otwórz plik, a następnie użyj polecenia Format Document, które ustawi wcięcia i rozbije dane na linie bez zmiany ich znaczenia.
- Pobranie programu - pobierz Visual Studio Code wyłącznie z oficjalnej strony producenta, a nie z banera „download” na stronie pośredniczącej.
- Otwarcie pliku - wybierz File > Open File i wskaż kopię pliku JSON.
- Formatowanie - naciśnij prawym przyciskiem w edytorze i wybierz Format Document albo użyj palety poleceń.
- Kontrola błędów - otwórz panel Problems, aby zobaczyć komunikat oraz numer linii wskazany przez edytor.
- Bezpieczny zapis - użyj File > Save As i nadaj nową nazwę, zamiast od razu nadpisywać eksport aplikacji.
„Parafraza: obsługa JSON w Visual Studio Code obejmuje formatowanie dokumentu i sygnalizowanie problemów ze składnią.” - Visual Studio Code, JSON documentation, dostęp sprawdzony w 2026 r.
Visual Studio Code nie jest tym samym co pełne środowisko Visual Studio. To lżejszy edytor, który dla plików JSON sprawdza się także u osób, które nie programują.
Jak otworzyć i sformatować JSON online bez ryzyka?

JSON online możesz sprawdzić w walidatorze działającym w przeglądarce tylko wtedy, gdy plik nie zawiera haseł, tokenów API, danych klientów ani identyfikatorów kont. Najbezpieczniejszy wariant to lokalny Visual Studio Code, ponieważ plik nie opuszcza komputera.
Serwis może deklarować, że przetwarza dane lokalnie w przeglądarce, lecz przed wklejeniem czegokolwiek sprawdź jego politykę prywatności i sposób działania. Nie zakładaj, że każdy formater JSON działa wyłącznie na Twoim urządzeniu.
Kiedy nie przesyłać pliku JSON do konwertera online?
Nie przesyłaj pliku JSON online, jeśli zawiera sekret umożliwiający logowanie lub dane pozwalające zidentyfikować klienta.
- Token API - ciąg po polu api_key, token lub bearer może dawać dostęp do zewnętrznej usługi.
- Hasło - pole password, nawet zaszyfrowane lub zakodowane, nie powinno trafiać do przypadkowego serwisu.
- Dane klientów - adresy e-mail, telefony, zamówienia i adresy dostawy wymagają ostrożnego traktowania.
- Identyfikatory kont - client_id, session_id i refresh_token mogą ujawniać więcej, niż sugeruje ich nazwa.
- Konfiguracja firmowa - plik z nazwą serwera, ścieżkami sieciowymi lub kluczami dostępu otwieraj lokalnie.
OWASP Foundation w materiałach o zarządzaniu sekretami zaleca ograniczanie ich ujawniania do niezbędnego minimum (źródło: OWASP Cheat Sheet Series, 2025). To praktyczna zasada także dla zwykłego eksportu JSON.
Jak wykonać bezpieczną kontrolę JSON przed użyciem narzędzia online?
Najpierw utwórz kopię pliku, otwórz ją lokalnie i wyszukaj nazwy pól związanych z logowaniem, a dopiero potem rozważ użycie walidatora.
- Zrób kopię - skopiuj plik do folderu Dokumenty i pracuj na kopii, nie na jedynym eksporcie.
- Otwórz lokalnie - użyj Visual Studio Code albo Notepad++, aby podejrzeć pola bez wysyłania danych.
- Wyszukaj sekrety - użyj Ctrl+F dla słów password, token, secret, key, email i address.
- Usuń dane wrażliwe - w kopii zastąp wartości przykładowym tekstem, na przykład „USUNIETO”.
- Sprawdź usługę - przeczytaj politykę prywatności i unikaj stron pełnych fałszywych przycisków „pobierz teraz”.
Jeśli plik pochodzi z archiwum, najpierw sprawdź jego zawartość i sposób rozpakowania. Pomocna będzie instrukcja jak rozpakować plik ZIP.
Jak sprawdzić poprawność składni JSON i naprawić błąd?
Poprawny JSON wymaga podwójnych cudzysłowów wokół nazw pól i wartości tekstowych, przecinków wyłącznie między elementami oraz zamkniętych nawiasów klamrowych i kwadratowych. RFC 8259 opisuje te zasady, dlatego komunikat syntax error najczęściej oznacza drobną, konkretną usterkę w wskazanej linii.
Nie klikaj automatycznego „napraw wszystko” bez porównania z kopią. Program może sformatować tekst, ale nie wie, czy usunięta wartość była istotnym ustawieniem aplikacji.
Jakie błędy składni JSON pojawiają się najczęściej?
Najczęściej JSON przestaje działać przez końcowy przecinek, pojedynczy cudzysłów, komentarz albo brak jednego nawiasu.
- Końcowy przecinek - zapis {"miasto":"Gdańsk",} jest błędny, ponieważ po ostatnim polu nie może zostać przecinek.
- Pojedyncze cudzysłowy - zapis {'miasto':'Gdańsk'} nie spełnia składni JSON, która wymaga znaków podwójnych.
- Brakujący nawias - obiekt otwarty znakiem { musi zostać zamknięty znakiem } we właściwym miejscu.
- Komentarze - dopisek zaczynający się od // może działać w pliku ustawień programu, ale nie w czystym JSON.
- Niekompletny plik - eksport przerwany podczas pobierania może kończyć się w środku tekstu lub tablicy.
JSON nie dopuszcza komentarzy i pojedynczych cudzysłowów, choć niektóre aplikacje używają podobnych formatów, takich jak JSONC. Nie poprawiaj pliku „na oko”, jeśli dokumentacja programu wymaga konkretnego wariantu.
Jak naprawić JSON krok po kroku?
Naprawę zacznij od kopii, potem sformatuj dokument lokalnie, popraw tylko pierwszy wskazany błąd i ponownie uruchom walidację.
- Zabezpiecz oryginał - utwórz kopię z dopiskiem -backup, aby móc wrócić do pierwotnego eksportu.
- Otwórz w VS Code - edytor zazwyczaj podkreśli problem i poda numer linii.
- Przejdź do linii - użyj Ctrl+G, wpisz numer komunikatu i obejrzyj znak przed oraz za wskazanym miejscem.
- Popraw jeden element - usuń nadmiarowy przecinek albo zamień pojedyncze cudzysłowy na podwójne tylko tam, gdzie są częścią składni.
- Sprawdź ponownie - sformatuj dokument jeszcze raz; kolejny komunikat może ujawnić następny błąd.
- Testuj w aplikacji - zaimportuj najpierw kopię do testowego profilu, jeżeli program oferuje taki wariant.
Przy pliku mającym setki megabajtów nie próbuj konwertować go w przeglądarce. Użyj edytora radzącego sobie z dużymi dokumentami albo poproś osobę obsługującą system o wyeksportowanie mniejszego zakresu danych.
Jak przekonwertować JSON do CSV lub Excela?

JSON najłatwiej zamienisz na CSV lub arkusz Excel, gdy zawiera płaską listę podobnych rekordów, na przykład produktów z polami nazwa, cena i stan. Microsoft Excel wykorzystuje do tego Power Query, narzędzie importu i transformacji danych; zagnieżdżone listy trzeba zwykle rozwinąć do osobnych kolumn lub tabel.
Nie istnieje gwarantowana bezstratna konwersja każdego JSON do jednego pliku CSV. CSV ma proste wiersze i kolumny, natomiast JSON może przechowywać listę adresów lub wiele pozycji jednego zamówienia.
Jak otworzyć JSON w Excelu przez Power Query?
W Excelu wybierz ścieżkę Dane > Pobierz dane > Z pliku > Z formatu JSON, a następnie rozwijaj rekordy i listy w oknie Power Query.
- Zachowaj kopię - przed importem nie zmieniaj oryginalnego eksportu z systemu źródłowego.
- Rozpocznij import - w Microsoft Excel przejdź do karty Dane i wybierz pobranie danych z pliku JSON.
- Sprawdź podgląd - Power Query pokaże, czy wykrył rekord, listę albo pojedynczą wartość.
- Rozwiń kolumny - kliknij ikonę rozwijania przy kolumnie Record lub List, aby wydobyć pola do tabeli.
- Ustaw typy - sprawdź daty, liczby dziesiętne i kody pocztowe, bo automatyczne rozpoznanie może je zmienić.
- Załaduj dane - wybierz Zamknij i załaduj dopiero po kontroli kolumn w podglądzie.
Microsoft opisuje Power Query jako narzędzie importu i transformacji danych w swoim ekosystemie. Nazwy przycisków mogą minimalnie różnić się zależnie od wersji Excela, dlatego przed publikacją instrukcję interfejsu należy sprawdzić w bieżącej dokumentacji Microsoft Learn.
Dlaczego po imporcie JSON kolumny są puste albo powielone?
Puste lub powielone kolumny po imporcie oznaczają zwykle, że JSON zawiera zagnieżdżony obiekt albo listę, której nie da się umieścić w jednej komórce bez wyboru sposobu mapowania.
- Płaska tabela produktów - rekordy z polami id, nazwa i cena można zwykle bezpośrednio zapisać jako CSV.
- Lista adresów - jeden klient mający trzy adresy wymaga osobnej tabeli adresów albo trzech powielonych wierszy klienta.
- Pozycje zamówienia - jedno zamówienie z pięcioma produktami powinno często trafić do tabeli zamówień i tabeli pozycji.
- Kodowanie UTF-8 - po eksporcie sprawdź polskie znaki, takie jak ą, ć i ł, szczególnie gdy otwierasz CSV w starszym programie.
- Separator CSV - w polskich ustawieniach systemu Excel często oczekuje średnika zamiast przecinka jako separatora kolumn.
Po konwersji otwórz pierwsze pięć i ostatnie pięć wierszy. Sprawdź, czy liczba rekordów się zgadza, a kwoty, daty oraz polskie znaki nie zostały uszkodzone. Osobne instrukcje znajdziesz w poradnikach konwersja JSON do CSV i jak otworzyć plik CSV w Excelu.
Co zrobić, gdy plik JSON nie chce się otworzyć albo jest nieczytelny?
Gdy plik JSON nie chce się otworzyć, najpierw sprawdź jego rozmiar, pełne rozszerzenie, komunikat błędu i źródło pobrania; nie zmieniaj przypadkowo nazwy ani kodowania oryginału. Najczęstsze przyczyny to uszkodzone pobieranie, błędna składnia, nietypowe kodowanie UTF-8 albo plik o innym formacie niż deklaruje nazwa.
Jak rozpoznać uszkodzony lub niepełny eksport JSON?
Uszkodzony eksport JSON często kończy się nagle w środku wiersza, ma rozmiar 0 KB albo zawiera komunikat serwera zamiast danych.
- Plik 0 KB - ponów eksport, ponieważ dokument nie zawiera danych do odczytu.
- Komunikat HTML - tekst zaczynający się od <html może być stroną błędu pobraną pod nazwą .json.
- Przerwany koniec - brak ostatniego nawiasu może oznaczać niepełne pobieranie albo błąd eksportu po stronie aplikacji.
- Losowe znaki - sprawdź kodowanie UTF-8 oraz spróbuj otworzyć plik w Visual Studio Code zamiast w prostym Notatniku.
- Blokada systemu - w Windows sprawdź Właściwości pliku i opcję Odblokuj, ale rób to wyłącznie dla plików z zaufanego źródła.
Jeżeli plik pochodzi z systemu firmowego, zgłoś administratorowi dokładny komunikat i godzinę eksportu. Zrzut ekranu z błędem oraz kopia niezmienionego pliku przyspieszą diagnozę.
Jak bezpiecznie odzyskać czytelny plik JSON?
Bezpieczne odzyskanie zaczyna się od ponownego pobrania pliku ze źródła i porównania rozmiaru obu wersji, a nie od przypadkowego konwertera.
- Pobierz plik ponownie - użyj oficjalnego panelu aplikacji i poczekaj na pełne zakończenie pobierania.
- Porównaj rozmiar - sprawdź Właściwości obu plików; podejrzanie mały dokument może być niekompletny.
- Pracuj na kopii - zachowaj pierwotny plik do czasu udanego importu lub naprawy.
- Otwórz lokalnie - użyj Visual Studio Code, aby odczytać numer linii i rodzaj błędu.
- Nie uruchamiaj instalatorów - nie pobieraj „JSON Reader Pro” z reklamy tylko dlatego, że obiecuje naprawę jednym kliknięciem.
- Poproś o nowy eksport - jeśli dane są ważne, źródłowa aplikacja lub jej pomoc techniczna powinna wygenerować poprawny plik.
Jedno praktyczne zdanie do zapamiętania: plik JSON najpierw otwieraj lokalnie, poprawiaj wyłącznie kopię, a do Excela importuj dopiero po sprawdzeniu struktury i kodowania UTF-8.
Najczęściej zadawane pytania

Czym otworzyć plik JSON w Windows?
Plik JSON otworzysz w Notatniku, Notepad++ albo Visual Studio Code. Notatnik nadaje się do szybkiego podglądu, a VS Code lepiej pokazuje strukturę, błędy i wcięcia.
Czy plik JSON można otworzyć w Excelu?
Tak, użyj w Excelu Power Query: Dane > Pobierz dane > Z pliku > Z formatu JSON. Ta metoda działa najlepiej przy powtarzalnych rekordach, na przykład liście produktów lub klientów.
Dlaczego JSON nie otwiera się poprawnie?
Najczęstszą przyczyną jest błąd składni, niepełne pobieranie albo plik zapisany w innym formacie mimo rozszerzenia .json. Otwórz kopię w Visual Studio Code i sprawdź numer linii z komunikatu.
Czy można edytować plik JSON ręcznie?
Tak, ale pracuj na kopii. Zachowaj podwójne cudzysłowy, przecinki między elementami i właściwe nawiasy, ponieważ jeden znak może zatrzymać import ustawień do aplikacji.
Czy otwieranie JSON online jest bezpieczne?
To zależy od zawartości pliku. Nie wklejaj do narzędzia online haseł, tokenów API, adresów klientów ani identyfikatorów kont; dla takich danych użyj lokalnego edytora.
Jak sformatować plik JSON?
W Visual Studio Code kliknij prawym przyciskiem w dokumencie i wybierz Format Document. Formatowanie porządkuje wcięcia i łamanie linii, ale nie powinno zmieniać danych.
Jak zamienić JSON na CSV?
Najpierw sprawdź, czy JSON jest listą podobnych rekordów. Następnie zaimportuj go przez Power Query, rozwiń pola do kolumn i zapisz wynik jako CSV, kontrolując separator oraz kodowanie UTF-8.
Źródła i literatura
Jakie dokumenty opisują składnię JSON?
Definicję składni, par klucz-wartość i wymóg podwójnych cudzysłowów oparto na formalnym standardzie RFC 8259.
Gdzie sprawdzić funkcje edytora i importu danych?
Funkcje Visual Studio Code należy weryfikować w dokumentacji producenta, a ścieżkę importu w Excelu - w aktualnej pomocy Microsoft, ponieważ interfejs może się zmieniać.
- RFC Editor - RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format, 2017.
- Visual Studio Code - JSON documentation, dostęp sprawdzony w 2026 r.
- Microsoft Learn - dokumentacja importu danych JSON w Power Query, sprawdzana przed publikacją w 2026 r.
- OWASP Foundation - OWASP Cheat Sheet Series: Secrets Management, 2025.
Redaktor technologiczny. Pisze o przesyłaniu i udostępnianiu plików, chmurze i bezpieczeństwie danych - prosto, konkretnie i na przykładach. Testuje narzędzia na własnych plikach, zanim je opisze.





