Json To Csv LogoJson To Csv

VS Code에서 JSON을 CSV로 변환하는 방법: 클릭부터 단축키 한 번까지, 4가지 방법 (2026 가이드)

VS Code에는 내장 JSON-CSV 변환 명령이 없지만, 네 가지 솔직한 방법이 있어요. 클릭 한 번으로 되는 확장 프로그램, jq나 Python을 쓰는 통합 터미널, 저장해 두는 tasks.json 작업, 설정 없이 쓰는 온라인 변환기예요. 각 방법을 실제 중첩 데이터로 테스트했어요.

업데이트: 2026-10-1510 분 소요

먼저 솔직하게 정리하면: VS Code는 편집기이지 변환기가 아니에요

메뉴를 다 뒤져 봤는데 못 찾았다면, 놓친 게 아니에요. VS Code에는 CSV로 변환 명령도, JSON용 내보내기 메뉴도, .json 파일을 .csv 파일로 바꾸는 내장 방법도 없어요. 실수가 아니에요. VS Code는 코드 편집기이고, 형식 변환은 확장 프로그램, 터미널, 작업에 맡기는 종류의 일이에요. 이걸 받아들이면 질문이 달라져요. "버튼이 어디 있지?"가 아니라 "이 파일에는 네 가지 방법 중 어느 게 맞지?"가 되죠.

네 가지 방법을 간단히 정리하면: 편집기 안에서 클릭 한 번으로 변환하는 확장 프로그램, jq나 Python으로 완전한 제어를 주는 통합 터미널, 매주 반복하는 변환을 위한 tasks.json 작업, 설정 없이 일회성 파일을 처리하는 온라인 변환기예요. 각 방법은 한 가지 일에 확실히 최고이고, 각 방법마다 다른 방법이 피하는 실패 지점이 있어요. 이 가이드에서는 네 가지 방법을 모두 다루며, 정확한 명령어와 정확한 출력을 담았어요. 실제 중첩 테스트 파일, 중첩된 고객 객체, 항목 목록, null 합계가 들어간 세 건 주문 JSON 문서로 실행한 결과예요.

방법 1: JSON2CSV 확장 프로그램 (파일 하나에 가장 빨라요)

지금 당장 파일 하나를 변환하고 싶다면 확장 프로그램이 가장 손이 덜 가요. 설치할 건 Visual Studio Code Marketplace에 있는 khaeransori의 JSON2CSV예요. README에 작업 순서가 분명히 적혀 있어요. 설치하고, JSON 파일을 열고, Ctrl+Shift+P(macOS에서는 Cmd+Shift+P)로 명령 팔레트를 열고, Convert JSON to CSV를 입력하면 변환된 CSV가 새 편집기 탭으로 열리고, Ctrl+S로 저장해요. 반대 방향인 CSV에서 JSON으로 변환도 같은 팔레트에서 할 수 있어요.

설치는 1분도 안 걸려요. Ctrl+Shift+X로 확장 보기를 열고, json2csv를 검색한 뒤, 게시자가 khaeransori인 항목에서 설치를 눌러요. 확장 프로그램 설치를 안전하게 지키는 두 가지 습관이 있는데, 여기에도 똑같이 적용돼요. 설치를 누르기 전에 게시자 이름이 맞는지 확인하고(인기 도구에는 비슷한 이름의 모조 확장 프로그램이 있어요), 다운로드 수와 최근 업데이트 날짜를 살펴보세요. 확장 프로그램은 여러분의 파일에 접근하면서 컴퓨터에서 코드를 실행하니, 게시자를 확인하는 잠깐의 시간이 어떤 기능 목록보다 값져요.

JSON2CSV가 맞지 않는다면 대안이 두 가지 있어요. DataMorph(Data Format Converter로 등록돼 있어요)는 오른쪽 클릭 메뉴나 명령 팔레트에서 CSV, JSON, Excel 사이를 변환하고, 여러 파일을 한 번에 변환하는 일괄 변환과 중첩 JSON의 스마트 평탄화를 내세워요. Algae Data는 더 가벼운 선택이에요. JSON 파일을 열고, 명령 팔레트에서 Algae: JSON to CSV를 실행하면 결과가 새 편집기 창에 열려요. 세 가지 모두 공개 목록이 있는 실제 Marketplace 확장 프로그램이에요. 설명이 가장 요란한 걸 고르는 게 아니라, 여러분의 파일에 맞는 기능 목록을 가진 걸 고르세요.

확장 프로그램 방법의 솔직한 한계는 데이터를 제3자 도구에 맡긴다는 점이고, 평탄화 방식도 그 도구 마음이라는 거예요. JSON이 깊이 중첩돼 있거나 컬럼 순서가 중요하다면, 아래 터미널 방법에서 두 가지를 명시적으로 제어할 수 있어요. 그래서 매주 JSON을 변환하는 개발자는 보통 방법 2나 방법 3으로 가게 돼요.

방법 2: 통합 터미널, 평탄한 데이터에는 jq, 중첩 데이터에는 Python

통합 터미널은 이 작업에서 VS Code의 가장 큰 강점이에요. Ctrl+`(백틱 키)를 누르면 편집기 안에 프로젝트 폴더 기준의 온전한 셸이 열리고, 파일이 옆에 열려 있어요. 창을 오갈 필요도, 업로드할 필요도 없고, 아래의 모든 명령은 다시 실행할 수 있어요. 거의 모든 파일은 두 가지 도구로 커버돼요. 빠른 평탄 변환에는 jq, 중첩된 모든 것에는 Python이에요.

jq부터 시작하세요. JSON 명령줄 프로세서예요. JSON이 평탄한 객체들의 배열이라면, 중첩 객체도 없고 행 안에 배열도 없다면, 명령어 하나로 전체 변환이 끝나요. 모든 행의 키를 모아서 헤더로 만들고, 각 행을 CSV로 내보내요.

jq: 평탄한 JSON 배열을 CSV로 (검증됨)
jq -r '(map(keys) | add | unique) as $cols | $cols, (.[] | [.[$cols[]]] | @csv)' flat.json > flat.csv

두 건 주문(id, 이름, 합계)이 들어간 평탄한 테스트 파일에 이 명령을 실행하면 정확히 이렇게 나왔어요. 헤더 행 id,name,total 뒤에 1,"Ana",24.5와 2,"Bo",9.0이 이어졌어요. 깔끔하고, 정확하고, 즉시 끝났어요. 그런데 같은 명령을 중첩 데이터에 쓰면 jq가 솔직하게 멈춰요. 중첩된 세 건 주문 테스트 파일에서는 "object is not valid in a csv row" 오류가 나왔어요. customer 같은 중첩 객체가 들어갈 CSV 셀이 없기 때문이에요. 이 오류는 jq가 진실을 말해 주는 거예요. 평탄한 도구에는 평탄한 행이 필요해요.

방법 2: 통합 터미널, 평탄한 데이터에는 jq, 중첩 데이터에는 Python (계속)

중첩 JSON에도 jq를 쓸 수 있는데, 컬럼을 명시적으로 지정하면 돼요. 이 레시피는 원하는 필드를 경로로 가져오고, items 목록을 "; "로 이어서 하나의 셀에 넣고, CSV로 써요.

jq: 명시적 컬럼이 있는 중첩 JSON (검증됨)
jq -r '["id","name","city","items","total"], (.[] | [.id, .customer.name, .customer.city, (.items | join("; ")), .total]) | @csv' orders.json > orders.csv

중첩 테스트 파일에 실행하면 "id","name","city","items","total" 헤더와 세 행이 나왔어요. 그중에는 1,"Ana","Oslo","book; pen",24.5와, items 목록이 비어 있고 합계가 null인 주문의 3,"Cy","Trondheim","",도 있어요. 알아두면 좋은 jq 동작이 두 가지 있어요. @csv는 모든 문자열에 따옴표를 붙이고(정확하지만 시끄러워요), null은 문자열 맥락에 들어갈 때만 빈 필드가 돼요. 세 번째 행의 빈 items 셀은 빈 목록에 대한 join에서 나왔고, null 합계는 행 끝에서 빈 필드로 찍혔어요. 명시적 컬럼은 명시적 제어를 뜻해요. 컬럼 순서, 중첩 경로, 각 목록이 무엇이 될지를 여러분이 정해요.

방법 2: 통합 터미널, 평탄한 데이터에는 jq, 중첩 데이터에는 Python (계속)

모든 컬럼을 일일이 지정하기가 귀찮아지면 Python이 더 좋은 도구예요. 이 작은 스크립트를 프로젝트에 convert.py로 저장하세요. 중첩 객체를 점 표기법 컬럼(customer.name)으로 펼치고, 일반 목록을 "; "로 이어주고, null을 빈 셀로 바꾸고, 표준 csv 모듈로 따옴표 처리를 맡겨 제대로 된 CSV를 써요.

convert.py, 중첩을 펼치는 JSON-CSV 변환 스크립트 (검증됨)
import json, csv, sys

def flatten(obj, prefix=""):
    out = {}
    if isinstance(obj, dict):
        for k, v in obj.items():
            key = f"{prefix}.{k}" if prefix else k
            out.update(flatten(v, key))
    elif isinstance(obj, list):
        out[prefix] = "; ".join(str(x) for x in obj if not isinstance(x, (dict, list))) if obj else ""
        for i, v in enumerate(obj):
            if isinstance(v, (dict, list)):
                out.update(flatten(v, f"{prefix}[{i}]"))
    else:
        out[prefix] = "" if obj is None else obj
    return out

rows = json.load(open(sys.argv[1]))
if isinstance(rows, dict):
    rows = [rows]
flat = [flatten(r) for r in rows]
cols = sorted({k for r in flat for k in r})
with open(sys.argv[2], "w", newline="", encoding="utf-8") as f:
    w = csv.DictWriter(f, fieldnames=cols)
    w.writeheader()
    w.writerows(flat)
print(f"wrote {sys.argv[2]}: {len(flat)} rows, {len(cols)} columns")

통합 터미널에서 python3 convert.py orders.json orders.csv로 실행하세요. 같은 중첩 테스트 파일에서 "wrote orders.csv: 3 rows, 5 columns"를 출력했고, 헤더는 customer.city,customer.name,id,items,total이 나왔고, 행은 Oslo,Ana,1,book; pen,24.5 / Bergen,Bo,2,mug,9.0 / Trondheim,Cy,3,, 였어요. null 합계와 빈 items 목록이 둘 다 약속한 대로 빈 셀로 들어갔어요. 이 스크립트는 실제로 마주치는 두 가지 형태를 처리해요. 최상위 배열(일반적인 경우)과 단일 최상위 객체(한 행짜리 표로 감싸요). 두 jq 레시피와 이 스크립트는 공개 전에 빌드 컴퓨터에서 실행했고, 위의 출력은 그림이 아니라 실제 출력이에요.

방법 3: 작업으로 저장하면, 매번 단축키 한 번으로 끝나요

한 달에 한 번 이상 JSON 파일을 변환한다면 명령어를 다시 입력하지 말고 VS Code 작업으로 저장하세요. 작업은 .vscode/tasks.json에 있는 이름 붙은 명령이고, 터미널에서 작업 실행 또는 단축키 Ctrl+Shift+B로 실행해요. 위의 Python 방법을 열려 있는 파일에 대한 단축키 한 번짜리 작업으로 바꿔 줘요.

프로젝트에 .vscode/tasks.json을 이 내용으로 만드세요(공개 전에 올바른 JSON으로 파싱되는지 확인했어요).

.vscode/tasks.json, 열려 있는 파일을 변환하는 작업 (파싱 검증됨)
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "JSON to CSV: convert current file",
      "type": "shell",
      "command": "python3 ${workspaceFolder}/convert.py ${file} ${fileDirname}/${fileBasenameNoExtension}.csv",
      "problemMatcher": []
    }
  ]
}

동작 원리는 이래요. ${file}은 활성 편집기에 열려 있는 파일, ${fileDirname}은 그 파일이 있는 폴더, ${fileBasenameNoExtension}은 .json을 뺀 이름이에요. 그래서 orders.json이 열려 있으면 이 작업은 convert.py로 그 파일을 변환해서 옆에 orders.csv를 써요. 아무 JSON 파일을 열고, Ctrl+Shift+B를 누르고, 작업을 고르면 원본 옆에 CSV가 나타나요. jq 레시피에도 같은 패턴이 통하고, 명령을 jq 줄로 바꾸고 입력을 ${file}로 하면 돼요. 한 가지 주의할 점은 작업이 여러분의 사용자 권한으로 셸 명령을 실행한다는 거예요. 그래서 신뢰하는 출처에서 온 작업만 추가하세요. 확장 프로그램과 같은 규칙을 설정에도 적용하는 거예요.

작업 방법에서 Python 스크립트가 jq보다 제 몫을 하는 지점도 바로 여기예요. 스크립트 하나와 작업 하나면 평탄한 파일, 중첩 파일, 단일 객체, 배열을 모두 처리하고, 파일마다 명령을 고칠 필요가 없어요. 매주 같은 API에서 받은 내보내기를 변환한다면, 이 방법이 보상을 주는 방법이에요.

방법 4: VS Code를 아예 건너뛰고 온라인 변환기를 쓸 때

편집기를 떠나는 게 맞는 상황이 세 가지 있어요. 첫째, 확장 프로그램을 설치할 수 없거나 jq나 Python이 없는 컴퓨터에서 일회성 파일을 처리할 때예요. 빌린 노트북, 잠긴 업무용 컴퓨터, 크롬북 같은 경우죠. 둘째, 중첩이 까다로워서 명시적인 jq 경로를 쓰는 게 일처럼 느껴지는 JSON일 때예요. 평탄화 토글이 있는 온라인 변환기는 전체 트리를 클릭 한 번으로 컬럼으로 바꾸고, 다운로드 전에 미리 보기도 볼 수 있어요. 셋째, 공유예요. CSV를 받을 동료가 VS Code를 쓰지 않는다면, 브라우저에서 변환해서 완성된 파일을 보내는 게 여러분의 도구 설명을 하는 것보다 간단해요.

이 사이트의 온라인 방법은 전부 브라우저 안에서 돌아가요. JSON을 붙여넣거나 파일을 업로드하면, 변환은 서버로 업로드 없이 클라이언트 쪽에서 일어나고, 중첩 데이터는 점 표기법 컬럼으로 펼쳐지고, 다운로드는 순수 UTF-8이에요. VS Code 사용자에게 솔직한 비교를 하자면, 온라인 변환기는 작업의 반복 가능성을 포기하는 대신 설정 제로와 즉시 미리 보기를 줘요. 변환이 반복된다면 편집기 방법을 쓰고, 반복되지 않는다면 브라우저 방법을 쓰세요.

VS Code 안에서 결과를 확인하기 (그리고 원본 텍스트가 진실인 이유)

어떤 방법을 택하든, CSV를 믿기 전에 VS Code에서 확인하세요. VS Code는 실제 파일, 실제 콤마, 따옴표, 줄바꿈을 보여주고, 스프레드시트는 그 해석을 보여줘요. 둘이 다르면 원본 텍스트가 진실이고 스프레드시트가 추측하는 거예요. 확인을 쉽게 해 주는 확장 프로그램이 두 가지 있어요. Edit CSV는 CSV를 편집 가능한 스프레드시트 형태 표로 편집기 안에서 열어 주고, Rainbow CSV는 각 컬럼마다 다른 색을 입혀서 어긋난 행이 눈에 바로 띄게 해 줘요.

가장 흔한 "CSV가 깨졌어요" 신고는 엑셀에서 한 개의 긴 컬럼으로 열리는 파일이에요. 열 번 중 아홉 번은 파일이 멀쩡해요. 엑셀이 구분자를 잘못 추측했거나(콤마로 열린 세미콜론 파일이 흔해요), 인코딩을 잘못 추측한 거예요. 먼저 VS Code에서 파일을 열어 보세요. 원본 텍스트에서 콤마와 따옴표가 제대로 보이면 파일이 맞는 거고, 고칠 건 가져오기 쪽이에요(엑셀: 데이터에서 텍스트/CSV 가져오기, 구분자와 65001 UTF-8 선택). VS Code 하단의 상태 표시줄에는 파일의 인코딩도 나와요. 파일이 깨져 보인다면 파일에서 다른 이름으로 저장에서 인코딩을 UTF-8로 해서 정규화하고, UTF-8(BOM 포함)로 저장은 특정 윈도우 도구가 BOM을 요구할 때만 쓰세요.

문제 해결: VS Code 사용자가 실제로 마주치는 네 가지 오류

유효하지 않은 JSON은 변환 전에 먼저 표시돼요. 파일에 빨간 물결선이나 문제 패널의 오류가 있으면 그걸 먼저 고치세요. 어떤 변환기도 잘못된 JSON을 받아들이지 않아요. VS Code 특유의 함정이 두 가지 있어요. 설정 스타일 파일은 주석과 후행 콤마를 허용하는데(그건 JSON이 아니라 JSONC예요), 마지막 요소 뒤의 후행 콤마 하나가 가장 흔한 문법 오류예요. 변환 전에 주석과 후행 콤마를 지우세요. VS Code 자체 JSON 언어 서비스가 보통 정확한 줄을 가리켜 줘요.

배열이 아니라 단일 객체예요. API는 빈 배열이 아니라 {"data": [...], "total": 2}나 단독 {...}를 자주 반환해요. 위의 Python 스크립트는 단독 객체를 한 행으로 감싸서 처리하고, 래퍼 객체에서는 안에 있는 배열이 행이 돼요. 먼저 배열을 추출하세요(jq에서는 .data | ..., Python에서는 rows = json.load(...)["data"]). 그렇지 않으면 변환기가 전체 배열을 하나의 셀에 문자열로 넣은 한 행을 내놓을 거예요.

중첩 데이터가 "사라져요." 평탄화는 항상 선택을 해요. 객체 목록은 단일 셀 표현이 없고, 위의 Python 스크립트는 일반 값 목록만 이어주고, 객체 목록은 인덱스가 있는 키(items[0].name)로 재귀해요. 목록에 객체가 들어 있고 출력이 이상해 보인다면 그건 데이터 손실이 아니라 평탄화 규칙이 드러나는 거예요. 컬럼마다 목록을 이을지, 행으로 펼칠지, 버릴지 정하고, 기본값을 조용히 받아들이지 말고 스크립트에 적으세요.

거대한 파일이에요. 편집기 안에서 200MB짜리 JSON 파일을 변환하는 확장 프로그램은 UI를 멈추게 할 수 있어요. 터미널 방법은 더 잘 스트리밍하고, 특히 jq는 미리 보기를 불러오지 않고 큰 파일을 처리해요. VS Code가 느리게 느껴진다면 그게 터미널을 쓸 신호예요. 명령줄에서 jq나 Python을 쓰고, 편집기는 결과만 보여 주게 하세요.

어떤 방법을 골라야 할까요?

파일 하나, 지금 당장, 설정 없이: JSON2CSV 확장 프로그램, 설치하고, 명령 팔레트에서 실행하고, 새 탭을 저장하세요. 매주 변환하는 파일: Python 스크립트와 tasks.json 작업, 단축키 한 번으로 매번 같은 결과가 나와요. 빠른 평탄 파일이고 터미널이 편하다면: jq 한 줄짜리. 잠긴 컴퓨터에서의 일회성 파일, 또는 확정하기 전에 미리 보고 싶은 까다로운 중첩: 온라인 변환기. 이 중 어느 것도 "바로" VS Code 방식은 아니에요. VS Code에는 의도적으로 단일 내장 방식이 없으니까요. 편집기는 부품을 주고, 여러분의 변환 빈도와 데이터 중첩에 맞는 조합이 맞는 방법이에요.

무료 JSON-CSV 변환기 열기

관련 가이드

자주 묻는 질문

VS Code에서 JSON을 CSV로 어떻게 변환하나요?

VS Code에는 내장 변환기가 없어서 네 가지 방법 중 하나를 추가하세요. JSON2CSV 확장 프로그램을 설치하고 명령 팔레트에서 Convert JSON to CSV를 실행하거나, 통합 터미널에서 jq(평탄한 데이터)나 Python 스크립트(중첩 데이터)를 쓰거나, 변환을 tasks.json 작업으로 저장해서 단축키 한 번으로 반복하거나, 일회성 파일은 무료 온라인 변환기에 JSON을 붙여넣으세요. 설정이 필요 없어요.

JSON을 CSV로 변환하는 데 가장 좋은 VS Code 확장 프로그램은 뭔가요?

khaeransori의 JSON2CSV가 가장 직접적이에요. 확장 보기에서 설치하고, JSON 파일을 열고, 명령 팔레트에서 Convert JSON to CSV를 실행하면 CSV가 새 탭으로 열려요. DataMorph(Data Format Converter)는 Excel 변환과 일괄 처리를 더하고, Algae Data는 더 가벼운 대안이에요. 어떤 확장 프로그램이든 설치 전에 게시자 이름을 꼭 확인하세요.

VS Code에서 확장 프로그램 없이 JSON을 CSV로 변환할 수 있나요?

네, 통합 터미널(Ctrl+`)을 쓰세요. 평탄한 JSON 배열에는 jq -r '(map(keys) | add | unique) as $cols | $cols, (.[] | [.[$cols[]]] | @csv)' file.json > file.csv를 쓰세요. 중첩 JSON에는 명시적 컬럼 경로가 있는 jq나, 중첩 객체를 점 표기법 컬럼으로 펼치는 작은 Python 스크립트를 쓰세요. 두 방법 모두 이 가이드를 위해 실제 데이터로 테스트했어요.

jq에서 "object is not valid in a csv row" 오류가 나는 이유는 뭔가요?

행에 중첩 객체나 배열이 들어 있기 때문이고, CSV 행에는 평탄한 값만 들어갈 수 있어요. 일반적인 jq @csv 레시피는 평탄한 행에서만 동작해요. 컬럼을 명시적으로 지정해서 고치거나(jq -r '["id","name",...], (.[] | [.id, .customer.name, ...]) | @csv'), 중첩 객체를 점 표기법 컬럼으로 바꾸는 Python 스크립트로 먼저 펼치세요.

VS Code에서 JSON-CSV 변환을 자동화하려면 어떻게 해야 하나요?

열려 있는 파일에 변환 명령을 실행하는 작업을 .vscode/tasks.json에 저장하세요. 예를 들어 python3 ${workspaceFolder}/convert.py ${file} ${fileDirname}/${fileBasenameNoExtension}.csv처럼요. 그리고 아무 JSON 파일이 열려 있을 때 Ctrl+Shift+B(터미널에서 작업 실행)를 누르세요. 매번 원본 파일 옆에 CSV가 쓰이고, 다시 입력할 필요가 없어요.

VS Code에서 만든 CSV가 엑셀에서 한 컬럼으로 열리는 이유는 뭔가요?

보통 파일은 멀쩡하고 엑셀이 구분자나 인코딩을 잘못 추측한 거예요. 먼저 VS Code에서 원본 텍스트를 확인하세요. 콤마와 따옴표가 거기서 제대로 보이면 파일이 맞는 거예요. 파일을 더블클릭하는 대신 엑셀에서 데이터에서 텍스트/CSV 가져오기로 다시 가져오고, 올바른 구분자와 65001(UTF-8) 인코딩을 선택하세요.

VS Code에서 주석이 있는 JSONC나 JSON을 CSV로 변환할 수 있나요?

직접은 안 돼요. 주석과 후행 콤마는 JSONC이지 JSON이 아니고, 어떤 변환기도 받아들이지 않아요. 먼저 주석과 후행 콤마를 지우세요(VS Code 문제 패널이 정확한 줄을 알려줘요). 그런 다음 깨끗한 JSON을 변환하세요. 설정 파일과 .code-workspace 파일도 마찬가지예요. 설계상 JSONC예요.

일회성 파일인가요? 브라우저에서 변환하세요, 확장 프로그램 없이

JSON을 붙여넣거나 파일을 업로드하세요. 중첩 데이터는 깔끔한 컬럼으로 펼쳐지고, 구분자와 따옴표는 자동으로 처리되며, 다운로드는 순수 UTF-8이에요. 무료, 가입 불필요, 전부 브라우저 안에서 돌아가요.

JSON-CSV 변환기 열기
모든 가이드