Clang 진단 구성하기

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

수행할 Clang 검사를 선택하고 편집하려면 다음과 같이 하세요:

1. 환경설정 > 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 탭에서 수행할 클래지 검사 수준을 선택합니다.

   

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

클래지 체크 레벨 선택

클래지 검사는 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 파일에 복사-붙여넣기합니다.