솔직히 말해서, 나는 JSON 포맷팅의 함정에 걸려 넘어진 사람을 너무 많이 봤다. 하늘을 뒤흔들 만한 큰 함정이 아니라, 매일 출근할 때마다 만나는, 혈압을 치솟게 만드는 사소한 문제들이다.
너도 분명 이런 상황을 겪어봤을 것이다: 백엔드 동료가 인터페이스 데이터를 던져주는데, 코드에 붙여넣으면, 세상에, 전부 한 줄에 빽빽하게 들어차 있어서 마치 개미가 이사 가는 것 같다. 특정 필드의 값을 확인하려면, 눈을 가늘게 뜨고 화면에서 한참을 찾아야 하고, 결국 눈이 거의 멀어버릴 지경인데, 알고 보니 중괄호 하나를 놓쳐서 전체 데이터가 엉망이 되어버렸다. 이때 백엔드 동료는 아주 순진한 척 말한다: "나 쪽은 문제없는데, 너 쪽에서 코드를 잘못 쓴 거 아니야?"
좋아, 책임 떠넘기기 대회가 이렇게 시작된다. 너는 한참을 조사하다가, 결국 형식이 제대로 안 보여서 쉼표 하나를 빠뜨리거나 따옴표를 하나 더 입력한 걸 발견한다. 이런 답답함은, 겪어본 사람만 안다.
더 웃긴 상황도 있다. 다른 사람의 프로젝트를 인수받아서 설정 파일을 열어보니, 그 안의 JSON이 한 줄로 압축되어 있고, 줄바꿈도 들여쓰기도 없어서 머리카락이 쭈뼛서게 만든다. 설정 항목을 바꾸고 싶어도, 어디에 있는지 전혀 찾을 수 없어서, 편집기로 한 글자씩 훑어봐야 하는데, 마치 틀린 그림 찾기 게임을 하는 것 같다. 고치고 나서도 마음이 편하지 않다. 혹시라도 손이 떨려서 괄호 하나를 지우면, 전체 설정이 바로 무너져서 온라인 서비스가 다운되고, 밤중에 사장님이 전화해서 무슨 일이냐고 물어보면, 너는 그저 "JSON 하나 고쳤어요"라고 말할 수밖에 없다.
웃지 마라, 이것들은 모두 실제로 일어난 피와 눈물의 역사다. 사실 문제의 근본 원인은 간단하다 – 너는 JSON 포맷팅 도구를 사용할 줄 모르거나, 아예 그런 생각조차 없다.
너는 아마 말할지도 모른다: "이거 참 쉬운 거 아니야? 아무 온라인 도구나 찾아서 쓰면 되잖아?" 말은 그렇게 하지만, 실제로 제대로 사용하는 사람은 드물다. 많은 사람들이 온라인 도구를 열고, 붙여넣고, 포맷팅 버튼을 누르고, 정리된 걸 보고 끝낸다. 하지만 이런 도구에 검증 기능이 있는지 생각해본 적 있는가? 네 JSON이 잘못되었는지? 잘못되었다면 어느 줄에서 잘못되었는지? 이런 것들이 모두 문제다.
진정한 포맷팅 도구는 지저분한 JSON을 가지런히 정리해줄 뿐만 아니라, 들여쓰기, 줄바꿈, 정렬을 한눈에 보이게 해주고, 어디에 문법 오류가 있는지 정확히 알려주며, 줄 번호와 열 번호까지 정확히 짚어준다. 붙여넣기만 하면, 바로 "3번째 줄 5번째 문자 근처에 쉼표가 하나 더 있습니다"라고 알려주니, 화면을 붙잡고 머리를 긁적일 필요가 없다.
게다가 지금은 많은 포맷팅 도구가 데이터 비교 기능도 지원한다. 예를 들어 두 개의 JSON이 있는데, 하나는 예전 인터페이스에서 가져온 것이고 다른 하나는 새 인터페이스에서 가져온 것이라면, 필드에 어떤 변화가 있는지 확인하고 싶을 때, 수동으로 비교하면 죽을 만큼 힘들지만, 도구를 돌리면 차이점이 하이라이트되어 어디가 바뀌었고 어디가 삭제되었는지 한눈에 알 수 있다. 이런 기능은 연동 테스트할 때 정말 생명의 은인이다. 매번 백엔드에게 "이 필드 이름이 바뀐 거 아니야?"라고 확인하지 않아도 된다.
더 실용적인 것은, 어떤 도구는 JSON을 다른 형식으로 변환하는 것을 지원한다는 점이다. 예를 들어 CSV 표로 변환하면 엑셀에 붙여넣어 비개발 직원에게 보여주기 쉽다. 또는 YAML 설정으로 변환하면 설정 파일을 작성하기 편리하다. 이런 기능은 자주 쓰이지는 않지만, 중요한 순간에 너를 아주 전문적으로 보이게 해준다.
어떤 사람들은 도구를 쓰는 것이 자신의 능력이 부족하다는 증거라고 생각할지도 모른다. 정반대다. 도구를 잘 활용하는 사람이 진짜 똑똑한 사람이다. 계산기를 쓸 줄 아는 것이 수학을 못한다는 뜻이 아니라, 더 가치 있는 일에 에너지를 쏟을 줄 안다는 뜻이다. 코드를 작성할 때도 마찬가지다. 10분 동안 머릿속으로 JSON을 분해하는 것보다, 10초 동안 도구로 분해하게 하고, 10초 동안 로직을 이해한 다음, 남은 시간을 비즈니스 문제를 고민하는 데 쓰는 것이, 이것이야말로 고수가 할 일이다.
그러니 다음에 또 그렇게 한 덩어리로 뭉쳐진 JSON을 받으면, 억지로 참지 마라. 복사해서 포맷팅 도구에 붙여넣고, 1초 만에 원래 모습을 드러내게 하라. 다시 백엔드가 책임을 떠넘기면, 포맷팅된 데이터와 오류 메시지를 그대로 되받아쳐라. 근거가 명확하니, 그가 또 "나 쪽은 문제없어"라고 말할 수 있을지 보자. 요즘 세상에, 도구를 좀 다루지 못하면, 손해 보는 건 너 자신이다. 더 이상 JSON 포맷팅 같은 사소한 일이 네 하루의 좋은 기분을 망치지 않게 하고, 동료들 사이에서의 믿음직한 이미지도 망치지 않게 하라.
도구는 죽은 것이고, 사람은 살아있는 것이다. 좋은 도구를 잘 활용하면, 복잡한 업무 속에서 힘을 아끼고, 적게 떠넘김을 받고, 더 많은 실질적인 일을 할 수 있다. 이보다 더 좋은 게 어디 있겠는가?