JSON फ़ाइल क्या है, उसे किससे खोलें, और उसे कैसे संपादित करें

सार: JSON फ़ाइल खोलने से पहले उसकी एन्कोडिंग और BOM की पुष्टि करें, फिर जाँचें कि संरचना केवल object या array है; संपादन के बाद हमेशा parser से सत्यापित करें, कोष्ठक और comma आँख से देखकर नहीं।

यह बस .json एक्सटेंशन वाली सादा-पाठ (plain-text) फ़ाइल है, जिसे Notepad भी खोल सकता है। असली सिरदर्द "यह नहीं खुलती" नहीं, बल्कि यह है कि खुलने के बाद आपको दिखता नहीं कि आपने क्या तोड़ा।

1. JSON फ़ाइल के भीतर वास्तव में क्या होता है

वैध JSON फ़ाइल में दो में से केवल एक चीज़ हो सकती है: object {...} या array [...]। और कुछ भी अनुमत नहीं — न चर घोषणा, न टिप्पणी, न फ़ंक्शन।

复制{
  "name": "order service",
  "port": 8080,
  "debug": false,
  "upstream": ["10.0.0.11", "10.0.0.12"],
  "timeout": null
}

संरचनात्मक रूप से तीन चीज़ें पहचानना काफ़ी है:

फ़ाइल का एक्सटेंशन सामग्री तय नहीं करता: package.json, tsconfig.json और composer.json सब एक ही तरह की चीज़ें हैं; अलग-अलग टूल ने बस सहमति बनाई है कि वे उनमें से अलग-अलग key पढ़ेंगे।

2. खोलने के तीन तरीके, परिस्थिति के अनुसार चुनें

बस एक नज़र देखना है: ब्राउज़र में खोलें। फ़ाइल को Chrome या Edge विंडो में खींच लाएँ और ब्राउज़र उसे जैसा है वैसा दिखा देगा; यदि JSON Viewer एक्सटेंशन लगा है, तो यह स्वतः सुसज्जित (pretty-print) और संक्षिप्त करने योग्य हो जाता है।

सामग्री संपादित करनी है: संपादक इस्तेमाल करें। VS Code, Sublime और Notepad++ सभी JSON सिंटैक्स हाइलाइटिंग और ब्रैकेट मिलान लाते हैं, और VS Code में Shift + Alt + F दस्तावेज़ को प्रारूपित करता है। ध्यान रखें कि Windows Notepad सहेजते समय BOM जोड़ सकता है, इसलिए आपके कॉन्फ़िगरेशन बदलाव प्रभावी न हों; उससे बचना बेहतर है।

कुछ इंस्टॉल नहीं करना, बस सत्यापित करना है: ऑनलाइन JSON formatter इस्तेमाल करें। सामग्री चिपकाएँ और तुरंत पंक्ति व स्तंभ संख्या, त्रुटि स्थान और संक्षिप्त करने योग्य tree दिख जाता है; काम होने पर परिणाम कॉपी कर लें। डेटा ब्राउज़र में स्थानीय रूप से संसाधित होता है और सर्वर पर नहीं भेजा जाता।

बड़ी फ़ाइलें (दसियों MB या अधिक): उन्हें ज़बरदस्ती संपादक में न खोलें। VS Code में 100 MB की JSON फ़ाइल खोलने पर वह तब तक अटकी रहेगी जब तक आप अपने जीवन के फ़ैसलों पर सवाल करने न लगें; पहले कमांड लाइन से संरचना देखें:

复制# Look at the first 20 lines to confirm whether it is an array
head -n 20 data.json

# Use jq to list top-level keys without loading the whole file
jq -r 'keys[]' data.json | head

# Count the array length
jq 'length' data.json

3. डबल-क्लिक करने पर गड़बड़ पाठ खुले तो क्या करें

तीन कारण, हर एक का अलग समाधान:

1. यह वास्तव में बाइनरी फ़ाइल है (उदाहरण के लिए कोई संपीड़ित संग्रह, या निर्यातित डेटाबेस फ़ाइल, जिसका एक्सटेंशन .json है)। file data.json से असली प्रकार देखें; उसे ज़बरदस्ती पाठ मानकर न चलाएँ।
2. एन्कोडिंग UTF-8 नहीं है। GBK में एन्कोडेड चीनी पाठ UTF-8 वातावरण में गड़बड़ दिखता है। संपादक के "Reopen with encoding" से GBK एक बार आज़माएँ; यदि सही दिखे, तो UTF-8 में सहेजें।
3. फ़ाइल एन्क्रिप्ट या संपीड़ित की गई है। लक्षण शुरुआत में PK (zip) या ढेर सारे प्रश्नचिह्न हैं; ऐसी फ़ाइलें पहले खोलनी या डीक्रिप्ट करनी होंगी।

4. संपादन के बाद कुछ टूटा नहीं, यह कैसे पुष्टि करें

JSON में शून्य सहनशीलता है: एक गायब comma, एक अतिरिक्त comma, या एक गायब उद्धरण और पूरी फ़ाइल मर जाती है, और बताया गया त्रुटि स्थान अक्सर अगली पंक्ति पर होता है। इसलिए संपादन के बाद सत्यापन अनिवार्य है; आँखों पर भरोसा न करें।

तीन उच्च-जोखिम संपादन क्रियाएँ, जितनी बार झंझट करती हैं उसी क्रम में:

सत्यापन सरल है: ऑनलाइन validator में चिपकाकर लाल पाठ देखें, या कमांड लाइन पर एक पंक्ति चलाएँ:

复制python3 -m json.tool config.json > /dev/null && echo OK

यदि OK छपे, तो फ़ाइल वैध है। यदि फ़ील्ड प्रकार भी सत्यापित करने हैं (उदाहरण के लिए port संख्या होनी चाहिए और name खाली नहीं होना चाहिए), तो JSON Schema लिखना मनुष्य की आँखों से कहीं अधिक भरोसेमंद है।

5. .json अपने करीबी रिश्तेदारों से कैसे अलग है

tsconfig.json में टिप्पणियाँ देखकर हैरान न हों; उसे वास्तव में .jsonc के रूप में संभाला जाता है। वही सामग्री JSON.parse को दें और वह त्रुटि देगा। जब इनके बीच रूपांतरण चाहिए, तो JSON5 से JSON से एक क्लिक में टिप्पणियाँ और trailing comma हटाएँ।

6. कब भंडारण प्रारूप बदलने का समय आता है

JSON उन परिस्थितियों के लिए उपयुक्त है जहाँ "संरचना तय नहीं है, मनुष्यों को पढ़ना है, और यह भाषाओं के पार जाती है"। यदि फ़ाइल दसियों MB से बड़ी हो जाए, फ़ील्ड संरचना स्थिर हो, और आपको शर्त-आधारित क्वेरी चाहिए, तो JSON पर टिके रहना अपने लिए झंझट बनाना है — SQLite, Parquet पर जाएँ, या उसे डेटाबेस में लोड करें; पढ़ने/लिखने का प्रदर्शन परिमाण के क्रम से अलग होता है। विशिष्ट समझौतों के लिए देखें बड़े JSON का पार्सिंग और स्ट्रीमिंग।

अक्सर पूछे जाने वाले प्रश्न

खोलने के लिए बहुत बड़ी JSON फ़ाइल का निरीक्षण कैसे करूँ?

उसे ज़बरदस्ती संपादक में न खोलें; VS Code में 100 MB की JSON फ़ाइल खोलने पर वह तब तक अटकी रहेगी जब तक आप अपने जीवन के फ़ैसलों पर सवाल करने न लगें। पहले कमांड लाइन से संरचना देखें: head -n 20 बताता है कि यह array है या नहीं, jq -r 'keys[]' केवल शीर्ष-स्तरीय key सूचीबद्ध करता है, और jq 'length' array की लंबाई गिनता है। इनमें से कोई भी कमांड पूरी फ़ाइल लोड नहीं करता।

Notepad में किए गए मेरे संपादन कॉन्फ़िगरेशन को प्रभावी होने से क्यों रोकते हैं?

Windows Notepad सहेजते समय BOM जोड़ सकता है, और BOM वाली फ़ाइल कॉन्फ़िगरेशन पार्सिंग में विफल होती है, इसलिए संपादित सामग्री कभी प्रभावी नहीं होती। लेख की सिफ़ारिश है कि VS Code, Sublime या Notepad++ जैसे संपादक इस्तेमाल करें, जो JSON सिंटैक्स हाइलाइटिंग और ब्रैकेट मिलान देते हैं। यदि आप पहले ही Notepad इस्तेमाल कर चुके हैं, तो "UTF-8 without BOM" के रूप में दोबारा सहेजें और फिर आज़माएँ।

क्या मैं JSON फ़ाइल को JSON5 मानकर टिप्पणियाँ जोड़ सकता हूँ?

नहीं — मानक parser .json फ़ाइल में टिप्पणियाँ अनुमत नहीं करता और JSON.parse तुरंत त्रुटि देता है। टिप्पणियाँ .jsonc या .json5 फ़ाइलों में जाती हैं जिन्हें उनका मिलान करने वाला parser पढ़ता है। tsconfig.json जैसी फ़ाइलें वास्तव में .jsonc के रूप में संभाली जाती हैं; वही सामग्री JSON.parse को दें और वह विफल होता है।