Python에서 JSON을 YAML로 변환
양방향 변환을 위한 복사용 Python 코드와 출력을 올바르게 유지하는 옵션.
JSON입력
YAML출력
출력의 각 줄을 기본 서식으로 보여 주고, 그 줄에 담긴 값의 경로를 옆에 표시합니다. 줄을 클릭하면 경로가 복사됩니다.
전부 브라우저에서 실행되며 아무것도 업로드되지 않습니다. 스팸과 봇을 막기 위해 공정 사용 제한(입력당 5 MB, 변환 횟수 제한)이 적용됩니다.
PyYAML로 JSON을 YAML로, 그리고 다시 되돌리기
PyYAML과 표준 json 모듈이면 양방향 모두 처리할 수 있습니다. 다음 옵션을 쓰면 가장 깔끔한 출력을 얻습니다.
import json
import yaml # pip install pyyaml
with open("data.json", encoding="utf-8") as f:
data = json.load(f)
with open("data.yaml", "w", encoding="utf-8") as f:
yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True) import json
import yaml # pip install pyyaml
with open("data.yaml", encoding="utf-8") as f:
data = yaml.safe_load(f)
with open("data.json", "w", encoding="utf-8") as f:
# default=str turns dates and datetimes into strings
json.dump(data, f, indent=2, ensure_ascii=False, default=str) 다중 문서 YAML과 YAML 1.2
Kubernetes 스타일 파일의 모든 문서는 safe_load_all로 읽거나, YAML 1.2 규칙과 정밀한 들여쓰기가 필요하면 ruamel.yaml을 사용하세요.
import json
import yaml
with open("manifests.yaml", encoding="utf-8") as f:
docs = list(yaml.safe_load_all(f)) # one item per --- document
print(json.dumps(docs, indent=2, default=str)) import json
import sys
from ruamel.yaml import YAML # pip install ruamel.yaml
yaml = YAML() # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)
with open("data.json", encoding="utf-8") as f:
yaml.dump(json.load(f), sys.stdout) Python 한 줄 명령
PyYAML이 설치되어 있다면 셸 스크립트와 CI에서 편리하게 쓸 수 있습니다.
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml
# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json 흔한 문제와 해결 방법
PyYAML로 변환할 때 가장 자주 겪는 의외의 문제들입니다. 하나를 골라 수정 전과 후를 확인하세요.
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 키가 정렬되어 나옴 | safe_dump는 기본적으로 키를 정렬합니다. | sort_keys=False를 전달하세요. |
| é가 "\xE9"로 바뀜 | 비ASCII 문자는 기본적으로 이스케이프됩니다. | allow_unicode=True를 전달하세요. |
| yes / no / on / off | PyYAML은 YAML 1.1을 따르므로 따옴표 없는 no는 False로 로드됩니다. | YAML에서 따옴표를 붙이거나 ruamel.yaml(YAML 1.2)을 사용하세요. |
| TypeError: datetime is not JSON serializable | safe_load는 2026-10-01을 date 객체로 바꿉니다. | json.dump에 default=str을 전달하세요. |
| load()에 Loader 누락 | PyYAML 6에서는 yaml.load에 Loader가 필요합니다. | 파일의 코드를 절대 실행하지 않는 yaml.safe_load를 사용하세요. |
| 첫 번째 문서만 읽힘 | safe_load는 문서 하나만 읽습니다. | ---로 구분된 파일에는 safe_load_all을 사용하세요. |
더 많은 도구
JSON과 YAML이 만나는 모든 곳을 위한 변환기, 검사기, 단계별 가이드.
변환기
포맷팅 및 검사
용도별 변환
- Kubernetes kubectl JSON 출력과 API 객체를 바로 적용할 수 있는 깔끔한 매니페스트로 변환합니다.
- Docker Compose 포트, 환경 변수, 볼륨을 포함한 compose.yaml을 JSON으로 만듭니다.
- GitHub Actions on: 이 true가 되는 함정 없이 JSON으로 워크플로 파일을 작성하세요.
- OpenAPI / Swagger OpenAPI 3와 Swagger 2.0 명세를 JSON과 YAML 사이에서 변환합니다.
- CloudFormation AWS CloudFormation 템플릿을 내장 함수까지 포함해 JSON에서 YAML로 변환합니다.
자주 묻는 질문
Python에서 JSON을 YAML로 어떻게 변환하나요?
json.load로 JSON을 불러오고 PyYAML의 yaml.safe_dump로 작성하세요: yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). 두 옵션으로 키 순서와 비ASCII 문자가 그대로 유지됩니다.
Python에서 YAML을 JSON으로 어떻게 변환하나요?
yaml.safe_load로 파일을 읽고 json.dump(data, f, indent=2, default=str)로 작성하세요. 파일에 ---로 구분된 문서가 여러 개 있다면 yaml.safe_load_all을 사용하세요.
PyYAML과 ruamel.yaml 중 무엇을 써야 하나요?
PyYAML은 가장 흔한 선택이며 일회성 변환에는 충분합니다. ruamel.yaml은 YAML 1.2를 구현하고, 기존 YAML을 편집할 때 주석과 키 순서를 보존하며, 들여쓰기를 더 세밀하게 제어할 수 있습니다.
load 대신 safe_load를 쓰는 이유는 무엇인가요?
전체 로더를 쓰는 yaml.load는 파일의 태그로부터 임의의 Python 객체를 만들 수 있어 신뢰할 수 없는 입력에는 위험합니다. safe_load는 dict, list, 문자열, 숫자, 불리언, None, 날짜 같은 기본 타입만 만듭니다.
아무것도 설치하지 않고 변환할 수 있나요?
네. 이 페이지 상단의 변환기는 브라우저에서 실행되며 Python, 패키지, 업로드가 필요 없습니다. JSON이나 YAML을 붙여넣고 결과를 복사하세요.