KO
내 도구

Properties를 YAML / JSON으로 변환 (역변환 포함)

Java .properties(Spring Boot application.properties)를 중첩 YAML이나 JSON으로, 또는 JSON/YAML을 .properties로 변환합니다. \uXXXX, 줄 이음, [0] 목록 지원.

.properties 값은 항상 텍스트입니다. 읽는 쪽에서 타입을 변환한다면(Spring처럼) 켜세요.
내 도구 →
광고

Spring Boot는 application.properties나 application.yml에서 설정을 읽는데, 둘 사이를 손으로 옮기면 느리고 실수하기 쉽습니다. 이 도구는 .properties 파일을 Java와 똑같이 읽습니다. 키와 값 사이의 =, :, 공백, 백슬래시 줄 이음, \uXXXX 이스케이프, #과 ! 주석을 모두 처리해 같은 설정을 중첩 YAML이나 JSON으로 써 줍니다. 반대로 JSON이나 YAML을 servers[0] 같은 목록 인덱스가 있는 key=value 줄로 펼칠 수도 있습니다.

사용 방법

  1. .properties 텍스트(또는 역방향이면 JSON/YAML)를 붙여넣습니다.
  2. 변환 방향을 고릅니다.
  3. 트리로 만들려면 "점으로 이어진 키를 중첩"을 켜 두고, Spring Boot 목록에는 "[0] 인덱스를 목록으로"를 켜 둡니다.
  4. YAML, JSON 또는 .properties 결과를 복사합니다.

계산식

a.b.c=v → a: b: c: v · list[0]=x → list: [x] · \uXXXX → 해당 문자 · \로 끝나는 줄 → 다음 줄로 이어짐

키는 이스케이프되지 않은 첫 =, : 또는 공백에서 끝납니다. 구분자와 그 주위의 공백은 건너뛰고, 값은 뒤쪽 공백을 포함해 나머지를 모두 유지합니다. 홀수 개의 백슬래시로 끝나는 줄은 앞쪽 공백을 뺀 채 다음 줄로 이어집니다. \t \n \r \f와 \uXXXX 이스케이프는 해석하고, 그 밖의 이스케이프 문자는 그 문자 자체를 뜻합니다. 같은 키가 두 번 나오면 Java처럼 마지막 값이 적용됩니다. 값은 숫자와 불리언에 타입을 달라고 요청하지 않는 한 텍스트로 남습니다(숫자로 썼을 때 그대로 되돌아오는 값만 해당하므로 1.50은 "1.50"으로 남음). .properties로 되돌릴 때 숫자는 JSON이나 YAML에 쓰인 그대로 복사되며(1.10은 1.10, 긴 ID도 모든 자릿수 유지), YAML 병합 키가 적용됩니다.

예시

샘플의 spring.datasource.url과 spring.datasource.username: app은 spring → datasource 아래로 들어가고, server.port = 8080은 파일에서처럼 텍스트인 port: "8080"이 됩니다. app.greeting=Hello\, w\u00f6rld는 Hello, wörld로 해석되고, app.servers[0]과 [1]은 항목 두 개의 목록이 되며, 두 줄에 걸친 description은 값 하나가 됩니다. 변환된 키는 모두 9개입니다.

자주 묻는 질문

8080에 왜 따옴표가 붙나요?

.properties 파일에는 타입이 없어서 모든 값이 텍스트입니다. Spring은 바인딩할 때 "8080"을 숫자로 바꾸므로 두 형식 모두 동작합니다. 숫자와 불리언을 따옴표 없이 쓰려면 옵션을 켜세요.

점이 들어 있는 키는 어떻게 유지하나요?

Spring Boot는 점이 들어 있는 맵 키에 대괄호를 씁니다. logging.level.[com.example]=DEBUG처럼요. 변환기는 이 형식을 읽고, .properties로 되돌릴 때도 이 형식으로 씁니다.

.properties 파일은 어떤 인코딩을 써야 하나요?

Java의 Properties.load(InputStream)는 ISO-8859-1로 읽으므로 ASCII가 아닌 문자는 \uXXXX 이스케이프(여기의 기본값)가 가장 안전합니다. Spring Boot와 Properties.load(Reader)는 UTF-8도 읽을 수 있습니다.

설정이 업로드되나요?

아닙니다. 변환은 브라우저에서 이뤄지므로 파일 속 비밀번호가 내 기기 밖으로 나가지 않습니다.

출처

최종 업데이트:

인용·퍼가기
APA

kakaoCalc. (2026, November 8). Properties를 YAML / JSON으로 변환 (역변환 포함). https://kakao.mobile/ko/tools/properties-to-json-tool/

MLA

“Properties를 YAML / JSON으로 변환 (역변환 포함).” kakaoCalc, 8 Nov. 2026, kakao.mobile/ko/tools/properties-to-json-tool/.

광고