01

먼저 원본과 작업 사본을 구분합니다

먼저 원본과 작업 사본을 구분합니다 핵심 안내 도식
핵심 읽기 · 먼저 원본과 작업 사본을 구분합니다

설정 파일이나 공개 API 응답을 받았는데 도구가 읽지 못하면 내용을 바로 고치기 쉽습니다. 그러면 어떤 문자가 원래 있었는지 알 수 없어 오류를 재현하기 어려워집니다. 먼저 원본을 보존하고 사본에서 한 가지 원인을 확인하는 방식으로 시작합니다.

이 글의 예시는 개인 정보가 없는 가상의 짧은 데이터입니다. 실제 업무 파일이나 토큰이 담긴 응답을 온라인 검사기에 그대로 올리는 절차를 권하지 않습니다. 프로젝트에서 허용한 로컬 도구를 사용하고 결과를 필요한 범위만 기록하세요.

02

파싱 성공은 문법을 읽었다는 뜻입니다

파싱 성공은 문법을 읽었다는 뜻입니다 핵심 안내 도식
핵심 읽기 · 파싱 성공은 문법을 읽었다는 뜻입니다

MDN의 JSON.parse 설명은 JSON 문자열을 해석하고 문법에 맞지 않으면 SyntaxError가 발생한다고 안내합니다. 마지막 항목 뒤의 불필요한 쉼표나 작은따옴표로 감싼 문자열은 JSON 문법 점검에서 확인할 대표적인 항목입니다.

예를 들어 {"count":2,}는 마지막 쉼표가 있는 연습용 오류이며 {"count":2}와 비교할 수 있습니다. 이 두 예시는 실제 서버 설정이 아닙니다. 자신이 받은 파일의 오류를 같은 문제로 단정하지 말고 도구가 가리키는 위치 주변을 먼저 읽습니다.

03

숫자와 문자열은 같은 모양이어도 다릅니다

숫자와 문자열은 같은 모양이어도 다릅니다 핵심 안내 도식
핵심 읽기 · 숫자와 문자열은 같은 모양이어도 다릅니다

{"code":"0012"}와 {"code":12}를 비교해 보세요. 앞의 값은 문자열로 적힌 코드이고 뒤의 값은 숫자입니다. 업무에서 앞자리 0이 의미 있는 식별자라면 겉모양만 보고 숫자로 바꾸면 원래 정보가 달라질 수 있습니다.

문법 검사에 통과한 뒤에는 각 필드의 정의를 제공 문서와 대조합니다. 날짜처럼 보이는 문자열도 그 형식과 시간대가 맞는지 별도로 확인해야 합니다. JSON이라는 파일 형식 자체가 업무 규칙까지 검사해 주지는 않습니다.

한눈에 비교하기
상황별 확인 항목 — 작은 화면에서는 표를 좌우로 밀어 볼 수 있습니다.
검사질문통과해도 남는 것
문법괄호·따옴표·쉼표가 맞는가필드 정의 확인
구조기대한 필드와 자료형인가업무 단위 확인
의미코드·수량·날짜 조건에 맞는가실제 사용 환경 검증
기록원본과 수정 내역이 남는가필요한 후속 확인
04

오류를 고칠 때는 한 번에 하나씩 변경합니다

오류를 고칠 때는 한 번에 하나씩 변경합니다 핵심 안내 도식
핵심 읽기 · 오류를 고칠 때는 한 번에 하나씩 변경합니다

연습 사본에서 쉼표 하나를 수정했다면 변경 전후의 한 줄과 도구 결과를 기록합니다. 여러 값을 동시에 고치면 무엇이 파싱 실패를 해결했는지 알기 어렵습니다. 실패 위치가 바뀌었다면 첫 수정이 해결한 범위와 남은 오류를 나누어 적습니다.

가상의 예시에서는 count를 숫자 2로 유지한 채 마지막 쉼표만 제거합니다. 이름이나 값의 의미까지 바꾸지 않는 것이 이 단계의 조건입니다. 문법 교정 과정과 업무 데이터를 수정하는 과정을 한 작업으로 섞지 마세요.

05

검사를 세 칸으로 분리합니다

검사를 세 칸으로 분리합니다 핵심 안내 도식
핵심 읽기 · 검사를 세 칸으로 분리합니다

첫 칸은 문법입니다. 도구가 파일을 해석할 수 있는지 기록합니다. 두 번째는 구조로, 기대한 필드와 자료형이 있는지 봅니다. 세 번째는 의미로, 값이 제공 문서의 단위와 조건에 맞는지 확인합니다. 세 단계의 완료 여부를 각각 적습니다.

예를 들어 문법 통과 / code 문자열 확인 / count의 단위 미확인이라고 남길 수 있습니다. 마지막 칸이 비어 있는데도 데이터 정상이라고 묶어 보고하지 않습니다. 기록을 받은 사람은 다음에 무엇을 확인해야 하는지 알아야 합니다.

06

재현 가능한 메모로 마무리합니다

재현 가능한 메모로 마무리합니다 핵심 안내 도식
핵심 읽기 · 재현 가능한 메모로 마무리합니다

메모에는 입력 파일의 출처, 사용한 도구, 바꾼 부분, 관찰 결과와 남은 질문을 넣습니다. 비밀값이 있다면 예시를 별도로 만들고 원래 값이 없는 연습 자료임을 표시합니다. 오류 메시지에 찍힌 경로나 토큰도 공유 전에 살펴봅니다.

이 글의 짧은 JSON 예제는 문법 차이를 설명하기 위한 것이며 모든 설정 형식을 다루지 않습니다. 프로젝트가 JSON 외에 다른 문법을 쓰는지 파일 종류부터 확인하세요. JSON.parse의 문법 설명은 MDN 공식 참조를 2026년 10월 11일 확인했습니다.

WORKBOOK

직접 적용해 보기: 문법 다음에 값의 의미

가상의 응답 {"count":2,}를 연습 사본에서 점검하는 상황입니다.

  1. 01

    원본과 연습 사본을 구분합니다.

  2. 02

    마지막 쉼표만 제거한 {"count":2}와 파싱 결과를 비교합니다.

  3. 03

    count의 단위는 별도 문서 확인이 필요하다고 적습니다.

남길 결과물

문법 오류 수정 / 숫자형 유지 / 수량 단위 미확인이라는 점검 기록입니다.

여기서 자주 놓치는 점

파싱 성공을 데이터 전체의 정확성 확인으로 보고하지 않습니다.

편집팀이 구성한 설명용 예시입니다. 실제 이용 후기나 측정 결과가 아닙니다.