Format Atlas

가이드

설정 파일 형식 선택하기

대상 도구가 허용하는 형식을 먼저 확인하세요. 여러 형식을 지원한다면 팀이 안전하게 검증하고 관리할 수 있는 형식을 고르세요.

어떤 형식을 선택해야 할까요?

작업 흐름에서 파일이 맡는 역할에 따라 선택하세요.

  • API와 웹 데이터 교환 → JSON
  • 읽기 쉬운 계층 설정 → YAML
  • 키와 값 중심의 설정 → TOML
  • 도구가 형식을 지정 → 해당 사양 준수

도구 지원을 우선 확인

설정 형식은 앱, 라이브러리, CI 시스템, 호스팅 환경에 따라 정해집니다. 지원 형식과 사양 버전을 확인하세요.

문법 검증 자동화

JSON, YAML, TOML 모두 문법이나 자료형 오류로 읽기에 실패할 수 있습니다. 저장 시 또는 CI에서 검증하고 저장소 설정 파일에 자격 증명을 넣지 마세요.

고려할 형식

JSON

적합한 용도: JSON을 허용하는 API나 설정

적합하지 않은 용도: 주석이 필요한 수동 관리 설정

YAML

적합한 용도: 사람이 관리하는 계층 설정

적합하지 않은 용도: 들여쓰기 오류가 걱정되는 단순 교환

TOML

적합한 용도: 키와 값으로 구성된 설정

적합하지 않은 용도: JSON이나 YAML을 지정하는 도구

내보내기 전 확인

  • 대상 도구가 지원하는 형식과 사양 버전을 확인하세요.
  • 저장소에 자격 증명이나 개인 키를 보관하지 마세요.

관련 비교

JSON vs TOMLJSON은 API와 프로그램 간 데이터 교환에 널리 쓰입니다. TOML은 사람이 편집하는 애플리케이션 설정용으로 설계되어 읽기 쉬운 키, 값, 테이블, 배열을 제공합니다.YAML vs TOMLYAML과 TOML은 사람이 편집하는 설정에 쓰이는 텍스트 형식입니다. YAML은 유연한 계층 구조를 지원하고 TOML은 키와 테이블로 명시적이고 읽기 쉬운 설정을 강조합니다. 도구와 데이터 구조에 맞춰 선택하세요.JSON vs YAMLJSON은 API와 프로그램 간 데이터 교환에 널리 쓰이는 엄격한 텍스트 형식입니다. YAML은 사람이 편집하는 설정과 구조화 데이터에 적합한 문법을 제공합니다. 도구 생태계와 작업 흐름에 맞춰 선택하세요.YAML vs XMLYAML과 XML은 모두 구조화 데이터를 표현합니다. YAML은 사람이 관리하는 설정에 편리하고, XML은 요소, 속성, 스키마, 네임스페이스에 의존하는 연동에서 흔히 쓰입니다.

가이드

데이터 교환 형식 선택수신 시스템의 규격부터 확인하세요. 구조화된 API 데이터에는 JSON, 기존 스키마 연동에는 XML, 단일 표에는 CSV를 사용하세요.웹 데이터와 설정 형식 선택API 같은 시스템 간 교환에는 JSON, 사람이 편집하는 설정에는 YAML, 기존 스키마 기반 연동에는 XML을 고려하세요.설정값과 비밀 정보의 보관 위치일반 설정값과 자격 증명을 분리하고, 로컬 개발·CI·운영 환경별 접근 범위에 맞는 보관 방법을 선택합니다.

참고 자료 및 사양