코드 미화 도구
Artistic Style, ClangFormat 또는 Uncrustify를 사용하여 소스 코드를 서식 지정합니다.
소스 코드 파일을 저장할 때 들여쓰기와 스타일을 자동으로 적용합니다. 미리 정의된 스타일을 사용하거나 사용자 정의 스타일을 설정할 수 있습니다.
Beautifier 환경 설정 지정
파일 미화 설정을 지정하려면 ‘ Preferences ’ > ‘ Beautifier ’ > ‘ General ’로 이동하십시오.
다음 표는 ‘ General ’ 탭에서 설정할 수 있는 환경 설정에 대해 설명합니다.
| 설정 항목 | 설명 |
|---|---|
| Automatic formatting on file save | ‘ Tool ’ 필드에서 선택한 도구를 사용하여 파일을 저장할 때 파일을 자동으로 정리합니다. 파일을 저장하는 동안 이 설정을 일시적으로 비활성화하려면 ‘ File ’로 이동하여 ‘ Save Without Formatting ’를 선택하십시오. |
| Tool | 소스 코드 파일 서식 지정에 사용할 도구입니다. 한 번에 하나의 도구만 선택할 수 있습니다. |
| Restrict to MIME types | 서식 조정할 파일의 MIME 유형을 세미콜론으로 구분하여 입력합니다. 모든 파일에 도구를 적용하려면 이 필드를 비워 둡니다. 이 설정은 저장 시 파일을 자동으로 정리할 때만 적용됩니다. 현재 열려 있는 파일의 서식을 지정하기 위해 메뉴 항목을 선택할 때 MIME 유형을 제한하려면, 도구별 탭에서 이 옵션을 지정하십시오. |
| Restrict to files contained in the current project | 현재 프로젝트에 속한 파일만 서식 정리합니다. |
포맷팅 도구 환경 설정
사용하려는 도구의 기본 설정을 지정하려면 ‘ Artistic Style ’, ‘ ClangFormat ’ 또는 ‘ Uncrustify ’ 탭으로 이동하십시오.
그런 다음, ‘ Configuration ’에서:
- Artistic Style command, ClangFormat command 또는 Uncrustify command 에서 도구 실행 파일의 경로를 지정합니다.
- Restrict to MIME types 에서 서식을 적용할 파일의 MIME 유형을 정의합니다. 이 설정은 현재 열려 있는 파일의 서식을 지정하기 위해 메뉴 항목을 선택할 때 적용됩니다.
- Options 에서 소스 파일에 적용할 스타일을 정의하는 구성 파일을 선택하십시오. 여러 옵션을 선택한 경우, 상단부터 순서대로 적용됩니다. 사용 가능한 옵션은 도구에 따라 다릅니다.
다음 옵션을 설정하려면 해당 도구 중 하나가 설치되어 있어야 합니다.
| 옵션 | 값 |
|---|---|
| Use file *.astylerc defined in project files Use file uncrustify.cfg defined in project files | 프로젝트 파일에 정의된 구성 파일을 선택한 도구의 구성 파일로 사용합니다. |
| Use specific config file Use file specific uncrustify.cfg | 선택한 도구의 구성 파일로 사용할 파일입니다. |
| Use file uncrustify.cfg in <$HOME> Use file .astylerc or acstylerc in <$HOME> | 사용자의 홈 디렉터리에 있는 지정된 파일을 선택한 도구의 구성 파일로 사용합니다. |
| Use customized style | 사용자만의 코드 스타일을 설정합니다. |
| Format entire file if no text was selected | 편집기에서 텍스트를 선택하지 않은 상태에서 ‘ Format Selected Text ’을 선택하면 파일 전체의 서식을 지정합니다. |
사전 정의된 ClangFormat 스타일 사용
사전 정의된 ClangFormat 스타일을 사용하려면, ‘ ClangFormat ’로 이동하여 ‘ Use predefined style ’에서 스타일을 선택하십시오.
File 을 선택하여 소스 파일과 동일한 디렉터리 또는 상위 디렉터리 중 하나에 위치한 .clang-format 또는 _clang-format 파일에서 스타일 구성을 불러옵니다.
Fallback style 에서 스타일 구성 파일을 사용할 수 없는 경우 사용할 대체 스타일을 선택합니다. 기본 스타일을 사용하려면 Default 를 선택합니다. 서식을 적용하지 않으려면 None 를 선택합니다.
스타일 정의
사용자 정의 스타일을 정의하려면 ‘ Use customized style ’를 선택한 다음 ‘ Add ’를 선택하십시오.
' Add Configuration ' 대화 상자에서 코드 스타일을 설정하십시오. 이 대화 상자에서는 구문 강조, 자동 완성 및 상황에 맞는 도움말을 제공합니다.
'소스 코드 미화 ' 및 '플러그인 활성화 및 비활성화'항목도 참조하십시오 .
Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
