Clang 진단 설정

Clang-Tidy 및 Clazy를 사용하여 C, C++, Objective-C 프로그램의 문제를 감지합니다.

실행할 Clang 검사를 선택하고 편집하려면:

1. ‘ Preferences ’ > ‘ Analyzer ’ > ‘ Clang Tools ’을 선택합니다.

   

2. ‘ Diagnostic configuration ’ 필드에는 수행할 검사 항목이 표시됩니다. 이 필드의 값을 선택하면 ‘ Diagnostic Configurations ’ 대화 상자가 열리며, 여기서 수행할 검사 항목을 선택하고 편집할 수 있습니다.

   

   대신 Clang-Tidy 구성 파일에서 검사를 수행하려면 ‘ Clang Tools ’ 탭에서 ‘ Prefer .clang-tidy file, if present ’를 선택하십시오.

3. Copy 을 선택하여 편집할 진단 항목을 복사합니다.

   

4. ' Diagnostic configuration name ' 필드에서 구성 이름을 지정한 다음 ' OK'을 선택합니다.
5. ' Clang Warnings ' 탭에서 ' Use diagnostic flags from the build system '를 선택하여 빌드 시스템의 경고 플래그와 같은 진단 플래그를 Clang 코드 모델로 전달하여 코드 편집기에 주석을 표시합니다.
6. Clang-Tidy Checks 탭에서 Select Checks 을 선택하여 수행할 검사를 지정합니다. 검사를 필터링하려면 Filter by name 필드에 문자열을 입력하십시오.

   

   사용 가능한 검사기에 대한 자세한 내용은 Clang 정적 분석기 문서를 참조하십시오.

7. 선택한 검사를 일반 텍스트로 편집하려면 ‘ Edit Checks as String ’를 선택하십시오.
8. ' Clazy Checks ' 탭에서 수행할 Clazy 검사 수준을 선택합니다.

   

9. 선택한 검사를 일반 텍스트로 편집하려면 ' Edit Checks as String'를 선택하십시오.
10. ' Filters ' 필드에서 주제를 선택하면 ' Checks ' 필드에 해당 영역과 관련된 검사만 표시됩니다. 선택한 영역의 검사를 필터링하려면 ' Filter by name ' 필드에 문자열을 입력하십시오.
11. 모든 검사를 다시 보려면 [ Reset Topic Filter]을 선택하십시오.
12. 온라인에서 검사에 대한 자세한 정보를 보려면, 각 검사 옆에 있는 ‘ Web Page ’ 링크를 선택하십시오.

Clazy 검사 수준 선택

Clazy 검사는 0에서 3까지의 레벨로 나뉩니다. 레벨 0의 검사는 매우 안정적이며 오탐이 거의 없는 반면, 레벨 3의 검사는 실험적입니다. 각 레벨에서 수행할 검사를 선택할 수 있습니다. 하위 레벨의 검사를 자동으로 포함하려면 ‘ Enable lower levels automatically ’를 선택하십시오.

Clang-Tidy 구성 파일 생성

Clang-Tidy는 각 소스 파일에 대해 해당 소스 파일의 가장 가까운 상위 디렉터리에 위치한 .clang-tidy 파일에서 구성을 읽습니다. 구성 옵션 중 명령줄 옵션과 일치하는 항목이 있는 경우, 명령줄 옵션이 우선 적용됩니다. 실제 적용되는 구성은 ` -dump-config`을 사용하여 확인할 수 있습니다.

Qt Creator 선택한 검사 항목을 기반으로 구성 파일을 자동으로 생성해 줍니다. 검사 항목을 파일 형식으로 저장하려면 다음과 같이 .clang-tidy 파일을 생성할 수 있습니다:

1. Edit Checks as String 를 선택하고 필드의 내용을 복사합니다.
2. clang-tidy -dump-config 의 출력을 .clang-tidy 라는 파일로 파이프 처리합니다. 예: clang-tidy -checks=-*,bugprone-*,cppcoreguidelines-avoid-* -dump-config > .clang-tidy
3. .clang-tidy 파일을 소스 코드의 상위 디렉터리로 이동합니다.

나중에 Qt Creator 를 사용하여 검사를 더 추가하려면, .clang-tidy 파일의 검사 항목을 Edit Checks as String 필드로 복사한 다음, 추가 검사를 선택하고 필드의 내용을 .clang-tidy 파일에 복사하여 붙여넣으십시오.