기획팀으로부터 전달받은 엑셀(.xlsx) 파일. 이제 이 데이터를 여러분의 웹 애플리케이션이나 테스트 스크립트에서 사용해야 합니다. Pandas나 SheetJS 같은 라이브러리를 설치하고, 파싱 코드를 작성하고, 데이터 타입을 확인하는 데 시간을 쏟고 계신가요?
단순한 일회성 변환 작업이라면, 더 빠른 방법이 있습니다. 이 글에서는 개발자의 시간을 아껴주는 가장 효율적인 엑셀 to JSON 변환 방법을 알려드립니다.
목표: 엑셀 시트 → JSON 객체 배열
우리가 원하는 결과물은 명확합니다. 엑셀 시트의 첫 번째 행을 key로, 그 아래의 각 행들을 value로 갖는 JSON 객체의 배열(Array of Objects)입니다.
시작 파일 (example.xlsx):
| id | name | role |
|---|---|---|
| 1 | Alice | admin |
| 2 | Bob | user |
최종 결과물 (result.json):
[
{
"id": 1,
"name": "Alice",
"role": "admin"
},
{
"id": 2,
"name": "Bob",
"role": "user"
}
]이 구조는 자바스크립트의 map, filter 함수로 다루기 쉽고, 대부분의 프런트엔드 프레임워크나 API 요청 본문에 바로 사용할 수 있습니다.
코드 없는 해결책: 온라인 XLSX to JSON 변환기
파싱 스크립트를 작성할 필요 없이, 이 모든 과정을 10초 안에 끝낼 수 있습니다. XLSX-Tool의 온라인 변환기는 개발자에게 가장 친숙한 ‘객체 배열’ 형태로 엑셀 데이터를 즉시 변환해 줍니다.
개발자를 위한 장점:
- 시간 절약: 라이브러리 설치, 코드 작성, 디버깅 시간이 필요 없습니다.
- 의존성 없음: 프로젝트에 불필요한 패키지를 추가하지 않아도 됩니다.
- 안전한 처리: 파일이 서버로 전송되지 않고, 모든 변환은 100% 브라우저 내에서만 이루어집니다.
사용법 (3단계)
- 파일 업로드: 위 링크 페이지에서 변환할
.xlsx파일을 선택합니다. - JSON 생성: 첫 번째 시트를 기준으로 JSON 코드가 즉시 생성됩니다.
- 복사 및 사용: ‘JSON 복사’ 버튼을 눌러 클립보드에 담은 뒤, 여러분의 코드 에디터에 붙여넣고 개발을 계속하세요.
DIY 대안: 직접 스크립트 작성하기
물론 직접 코드를 작성하여 변환할 수도 있습니다. 이 방법은 반복적인 자동화가 필요할 때 유용합니다.
- Python:
pandas라이브러리의read_excel()과to_json(orient='records')메서드를 조합하면 쉽게 변환할 수 있습니다. - Node.js:
xlsx또는sheetjs같은 라이브러리를 사용하면 엑셀 파일을 읽고 JSON으로 가공할 수 있습니다.
하지만 간단한 일회성 변환을 위해 라이브러리를 설치하고, 문서를 읽고, 코드를 작성하는 것은 종종 ‘경치 좋은 길’로 돌아가는 것과 같습니다. 급할 때는 온라인 변환기가 훨씬 효율적입니다.
깔끔한 JSON을 위한 전문가 팁
- 헤더(Header) 위생 관리: 헤더는 여러분의 JSON
key가 됩니다.user-name이나User Name대신userName(camelCase) 또는user_name(snake_case)처럼 프로그래밍 친화적인 이름을 사용하세요. 공백이나 특수문자는 피하는 것이 좋습니다. - 데이터 타입 일관성: 변환기는 숫자처럼 보이는 값은 숫자로, 나머지는 문자열로 변환하려고 시도합니다.
0777과 같은 값을 숫자가 아닌 문자열로 유지하려면, 엑셀에서 해당 셀의 서식을 미리 ‘텍스트’로 지정해두는 것이 안전합니다. - 시트는 하나만: 변환기는 엑셀 파일의 첫 번째 시트만 사용합니다. 변환하려는 데이터가 다른 시트에 있다면, 해당 시트를 첫 번째 위치로 옮긴 후 업로드하세요.
결론: 개발자의 시간은 소중합니다
API 모의 데이터(mock data)를 만들거나, 비개발팀이 전달한 데이터를 급하게 앱에 넣어야 할 때, 일회용 파싱 스크립트를 작성하는 데 시간을 낭비하지 마세요.