JSON 편집기 팁: 대용량 문서를 더 빠르게 다루기

최신 개발에서 JSON 작업은 피할 수 없습니다. API 응답, 설정 파일, 데이터베이스 내보내기 — JSON은 어디에나 있습니다. 파일이 수천 줄에 이르면 효율적인 편집 도구와 기법이 몇 분과 몇 시간의 차이를 만듭니다.

포맷팅과 가독성

자동 포맷팅

대용량 JSON 문서의 첫 번째 단계는 포맷팅입니다. 미니파이된 JSON은 읽을 수 없습니다:

{"users":[{"id":1,"name":"Alice","roles":["admin","editor"]},{"id":2,"name":"Bob","roles":["viewer"]}]}

포맷팅 후:

{
  "users": [
    {
      "id": 1,
      "name": "Alice",
      "roles": ["admin", "editor"]
    },
    {
      "id": 2,
      "name": "Bob",
      "roles": ["viewer"]
    }
  ]
}

JSON 포맷터로 JSON을 즉시 포맷하세요 — 붙여넣기, 포맷, 복사.

커맨드 라인 포맷팅

# jq - 표준
cat data.json | jq .

# Python (내장)
python3 -m json.tool data.json

# Node.js
node -e "process.stdout.write(JSON.stringify(JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')),null,2))" < data.json

탐색 기법

트리 뷰 vs 텍스트 뷰

1000줄 이상의 문서에서는 트리 뷰가 텍스트 편집보다 더 실용적입니다:

관련 섹션에 집중하기 위해 노드를 접기/펼치기
계층 구조에서의 위치를 보여주는 경로 탐색
노이즈를 필터링하기 위해 서브트리 내 검색

대상 접근을 위한 JSONPath

수천 줄을 스크롤하는 대신 JSONPath로 필요한 데이터에 직접 이동하세요:

# 세 번째 사용자의 이메일 가져오기
cat users.json | jq '.[2].email'

# 모든 관리자 사용자 가져오기
cat users.json | jq '.[] | select(.role == "admin")'

JSONPath 쿼리 가이드에서 더 알아보세요.

유효성 검사

구문 오류 잡기

일반적인 JSON 구문 오류:

후행 쉼표: {"a": 1, "b": 2,} — 허용되지 않음
작은따옴표: {'key': 'value'} — 쌍따옴표를 사용해야 함
인용되지 않은 키: {key: "value"} — 키는 인용되어야 함
주석: // this breaks — JSON에는 주석 구문이 없음

대부분의 편집기는 이러한 오류를 실시간으로 강조합니다. 빠른 유효성 검사를 위해 JSON 유효성 검사기가 정확한 오류 위치를 찾아줍니다.

스키마 유효성 검사

구문을 넘어, JSON이 예상 구조와 일치하는지 검증합니다:

# ajv-cli 사용
npx ajv validate -s schema.json -d data.json

포괄적인 내용은 JSON Schema 유효성 검사 가이드를 참조하세요.

조작 기법

키 정렬

일관된 키 순서는 diff를 더 깔끔하게 만듭니다:

jq -S . data.json > sorted.json

하위 집합 추출

필요한 필드만 추출합니다:

# 각 객체에서 특정 필드 추출
jq '[.[] | {name, email}]' users.json

# 조건으로 필터링
jq '[.[] | select(.age > 30)]' users.json

JSON 파일 병합

# 두 객체 병합
jq -s '.[0] * .[1]' base.json override.json

# 배열 연결
jq -s '.[0] + .[1]' list1.json list2.json

구조 변환

# 배열에서 룩업 맵 생성
jq 'INDEX(.[]; .id)' users.json

# 중첩 구조 평탄화
jq '[.departments[].employees[]]' org.json

대용량 파일 다루기

스트리밍 파싱

수 기가바이트 파일에서 스트리밍은 모든 것을 메모리에 로딩하는 것을 방지합니다:

# jq 스트리밍 모드
jq --stream 'select(.[0][-1] == "email") | .[1]' large.json

# Python 스트리밍
import ijson
for item in ijson.items(open('large.json'), 'item'):
    process(item)

분할 및 처리

# 큰 배열을 개별 파일로 분할
jq -c '.[]' large_array.json | split -l 1000 - chunk_

# 청크를 병렬로 처리
ls chunk_* | parallel jq '.name' {}

편집기별 팁

VS Code

포맷: Shift+Alt+F (또는 Cmd+Shift+P → "Format Document")
접기: 거터의 화살표를 클릭하여 섹션 접기
JSON Schema: "$schema" 추가로 자동 완성 획득
설정: JSON 파일에 "editor.formatOnSave": true

JetBrains IDE

구조 뷰: Alt+7로 JSON 트리 표시
탐색: Ctrl+Click으로 $ref를 따라가기
포맷: Ctrl+Alt+L로 재포맷

자주 묻는 질문

터미널에서 JSON을 편집하는 가장 좋은 방법은 무엇인가요?

빠른 편집에는 jq가 최고입니다 — 단일 명령으로 JSON을 쿼리, 필터링, 변환할 수 있습니다. 인터랙티브 편집에는 fx (npm 패키지)가 구문 강조와 접기가 있는 터미널 기반 JSON 탐색기를 제공합니다. 간단한 포맷팅에는 추가 종속성 없이 python3 -m json.tool이 작동합니다.

주석이 있는 JSON (JSONC)은 어떻게 처리하나요?

주석이 있는 JSON (VS Code 설정, TypeScript 설정에서 사용)은 유효한 JSON이 아닙니다. strip-json-comments 같은 도구가 파싱 전에 주석을 제거할 수 있습니다. VS Code에서는 적절한 구문 강조를 위해 파일 연결을 "JSON with Comments"로 설정하세요.