.toml · application/toml
TOML: TOML (최소 구성 파일 형식)
TOML v1.0은 INI 스타일의 [섹션] 헤더, 명시적인 문자열 따옴표, 기본 날짜·시간 리터럴 및 # 주석을 사용해 모호성 없이 해시 테이블에 매핑됩니다.
빠른 답변: TOML v1.0은 INI 스타일의 [섹션] 헤더, 명시적인 문자열 따옴표, 기본 날짜·시간 리터럴 및 # 주석을 사용해 모호성 없이 해시 테이블에 매핑됩니다. Rust Cargo.toml, Python pyproject.toml, Hugo/Netlify 설정 및 타입이 명확한 앱 구성.
| 구조 유형 | 계층형 |
|---|---|
| 사람 가독성 | 높음 |
| 중첩 지원 | 지원 |
| LLM 토큰 효율 | 보통 |
| 파일 확장자 | .toml |
| MIME 유형 | application/toml |
| 추천 용도 | Rust Cargo.toml, Python pyproject.toml, Hugo/Netlify 설정 및 타입이 명확한 앱 구성. |
장점
- YAML 특유의 들여쓰기 오류 및 암묵적 불리언 형변환 함정을 원천 제거
- 주석, RFC 3339 타임스탬프 및 깔끔한 점(.) 구분 중첩 키 지원
- Rust, Python 패키징 및 최신 CLI 도구의 표준 구성 파일 형식
단점 및 주의사항
- 깊게 중첩된 객체 배열은 JSON이나 YAML에 비해 표현이 길어질 수 있음
- 최상위 루트에 배열을 직접 둘 수 없어 명시적 테이블 키로 감싸야 함
- 언어 표준 라이브러리 내 기본 파서 지원은 JSON보다 적은 편임
참고 자료
TOML 로컬 변환 및 정리 도구
관련 엔지니어링 가이드
관련 형식
24개 형식 전체 보기TOML 자주 묻는 질문
Cargo와 pyproject.toml이 YAML 대신 TOML을 채택한 이유는 무엇인가요?
TOML은 따옴표 없는 모호한 문자열과 들여쓰기 마법을 금지하므로, 주석을 유지하면서도 어느 환경에서나 동일하게 안전하게 파싱됩니다.
TOML 파일 최상위에 JSON 배열을 직접 표현할 수 있나요?
아니요. TOML 루트 문서는 반드시 키-값 테이블이어야 하므로 최상위 배열은 보통 items나 root 같은 키 아래에 감싸 표현합니다.
TOML은 기존 INI 파일과 호환되나요?
[section] 문법은 INI에서 빌려왔지만 정수, 실수, 불리언, 배열 및 인라인 테이블 타입을 엄밀히 정의한 공식 v1.0 규격을 따릅니다.