YAML 유효성 검사기

사용 방법

1. YAML 내용을 텍스트 영역에 붙여넣습니다.
2. Validate 버튼을 클릭합니다 (Ctrl+Enter 단축키 사용 가능).
3. YAML이 유효하면 녹색 성공 메시지와 함께 파싱된 구조가 JSON 형식으로 표시됩니다.
4. YAML이 유효하지 않으면 오류 박스에 원인, 줄 번호, 열 번호 및 문제 코드 스니펫이 표시됩니다.

오류 출력 이해하기

유효성 검사 실패 시, 오류 박스에는 다음이 포함됩니다:

• 원인 — 무엇이 잘못되었는지에 대한 설명 (예: 잘못된 들여쓰기, 예상치 못한 스트림 종료).
• 줄 번호 & 열 번호 — 입력에서 오류의 정확한 위치.
• 스니펫 — 파서가 제공하는 주변 컨텍스트. 종종 문제 문자를 가리키는 ^가 포함됩니다.

일반적인 YAML 구문 오류

• 일관성 없는 들여쓰기 — YAML은 중첩에 공백만 사용해야 합니다 (탭 금지). 같은 레벨에서 2칸과 4칸 들여쓰기를 혼용하면 파싱 오류가 발생합니다.
• 키 뒤 콜론 누락 — key value는 유효하지 않습니다. key: value로 작성해야 합니다.
• 따옴표 없는 특수 문자 — 값에 :, #, [, ], {, } 등의 문자가 있으면 따옴표로 감싸거나 이스케이프해야 합니다.
• 탭 문자 — YAML은 들여쓰기에 탭을 허용하지 않습니다. 모든 탭을 공백으로 교체하세요.
• 중복 키 — 동일한 매핑 블록 내의 중복 키는 YAML 1.2에서 기술적으로 유효하지 않습니다.

예시: 유효한 YAML

server:
  host: localhost
  port: 8080
  tls: true

database:
  driver: postgres
  name: myapp
  credentials:
    user: admin
    password: "s3cr3t"

allowed_origins:
  - https://example.com
  - https://api.example.com

예시: 유효하지 않은 YAML (들여쓰기 오류)

server:
  host: localhost
   port: 8080   # 오류: 추가 공백으로 들여쓰기 불일치

유효성 검사기는 불일치가 감지된 줄 번호와 열 번호를 보고하여 문제를 쉽게 찾아 수정할 수 있습니다.