소스 코드 미화하기

코드 미화는 소스 코드 파일에 들여쓰기와 스타일을 적용하는 것을 의미합니다. 실험용 Beautifier 플러그인을 사용하여 다음과 같은 외부 도구를 사용하여 소스 코드의 서식을 지정할 수 있습니다:

• 예술적 스타일
• ClangFormat
• 언크러스티파이

Beautifier 플러그인은 소스 코드를 할당 문, if 블록, 루프 등과 같은 컴포넌트 구조로 구문 분석하고 Beautifier 기본 설정에 따라 서식을 지정합니다. 미리 정의된 스타일을 사용하거나 자신만의 스타일을 정의할 수 있습니다.

파일을 저장할 때 자동으로 서식을 지정하려면

1. 소스 코드 서식 지정에 사용할 도구를 다운로드하여 설치합니다:
   • 예술적 스타일
   • ClangFormat
   • 암호화 해제

   참고: 일부 플랫폼의 경우 소스에서 도구를 빌드해야 할 수도 있습니다.

2. Beautifier 플러그인을 활성화합니다.

   참고: Qt Creator 10.0.0부터는 ClangFormat 플러그인이 기본적으로 활성화되어 있습니다. 환경설정 > C++ > Formatting mode 로 이동하여 Disable 를 선택하여 ClangFormat을 끄고, 뷰티파이어를 활성화하면 예기치 않은 결과가 발생할 수 있으므로 이 두 플러그인을 함께 사용하면 안 됩니다.

3. 환경설정 > Beautifier > General 로 이동하여 사용할 도구를 선택합니다.

   

4. Tool 필드에서 선택한 도구를 사용하여 파일을 저장할 때 자동으로 파일을 미화하려면 Automatic formatting on file save 을 선택합니다.

   파일을 저장하는 동안 이 설정을 일시적으로 비활성화하려면 File 로 이동하여 Save Without Formatting 을 선택합니다.

5. Artistic Style, ClangFormat 또는 Uncrustify 로 이동하여 도구 실행 파일의 경로를 설정하고 사용할 스타일을 정의하는 구성 파일을 선택합니다.

   

   미화기 꾸미기 환경설정 해제

현재 열려 있는 파일 포맷하기

Tools > Beautifier > Artistic Style, ClangFormat 또는 Uncrustify 로 이동하여 현재 파일의 텍스트 서식을 지정하는 작업을 선택합니다.

작업에 대한 키보드 단축키를 만들 수 있습니다.

Format Current File 로 이동하여 현재 열려 있는 파일의 서식을 지정합니다.

ClangFormat으로 커서에서 포맷하기

커서 아래의 구문 서식을 지정할 텍스트가 선택되어 있지 않으면 Tools > Beautifier > ClangFormat > Format at Cursor 으로 이동합니다.

Format Line(s) 로 이동하여 선택한 줄의 서식을 지정합니다.

Disable Formatting for Selected Text 로 이동하여 // clang-format off 및 // clang-format on 내에서 선택한 줄을 줄 바꿈합니다.

크러스트 제거를 사용하여 선택한 텍스트 서식 지정하기

텍스트가 선택되지 않은 경우 Tools > Beautifier > Uncrustify > Format Selected Text 으로 이동하여 기본적으로 전체 파일의 서식을 지정합니다.

이 동작을 끄려면 환경설정 > Beautifier > Uncrustify 에서 Format entire file if no text was selected 의 선택을 취소하세요.