소스 코드 미화

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

• Artistic 스타일
• ClangFormat
• Uncrustify

Beautifier 플러그인은 소스 코드를 할당문, if 블록, 루프 등과 같은 구성 요소 구조로 분석한 후, Beautifier 환경 설정에 따라 서식을 지정합니다. 미리 정의된 스타일을 사용하거나 사용자 정의 스타일을 설정할 수 있습니다.

파일을 저장할 때 자동으로 서식을 적용하려면:

1. 소스 코드 서식을 지정하는 데 사용할 도구를 다운로드하여 설치하십시오:
   • Artistic 스타일
   • ClangFormat
   • Uncrustify

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

2. Beautifier 플러그인을 활성화하십시오.

   참고: Qt Creator 10.0.0부터 ClangFormat 플러그인은 기본적으로 활성화되어 있습니다. Preferences > C++ > Formatting mode 로 이동하여, Beautifier를 활성화할 경우 ClangFormat을 비활성화하려면 ‘ Disable ’를 선택하십시오. 두 플러그인을 함께 사용하면 예상치 못한 결과가 발생할 수 있습니다.

3. Preferences > Beautifier > General 로 이동하여 사용할 도구를 선택하십시오.

   

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

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

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

   

   Beautifier 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 태그로 감싸세요.

Uncrustify를 사용하여 선택한 텍스트의 서식을 지정합니다.

텍스트가 선택되지 않은 상태에서 Tools > Beautifier > Uncrustify > Format Selected Text 로 이동하면 기본적으로 전체 파일의 서식이 지정됩니다.

이 동작을 비활성화하려면 Preferences > Beautifier > Uncrustify 에서 Format entire file if no text was selected 를 해제하세요.