Clang 코드 모델

코드 모델은 사용자가 애플리케이션을 작성하는 데 사용하는 언어를 이해하는 IDE의 구성 요소입니다. 이는 Qt Creator 가 다음과 같은 서비스를 제공할 수 있게 해주는 프레임워크입니다:

• 코드 자동 완성
• 구문 및 의미 강조 표시
• 로케이터, 심볼 추적 등을 이용한 코드 내 탐색
• 클래스 브라우저, 개요 등을 이용한 코드 검사
• 진단
• 툴팁
• 심볼 찾기
• 심볼 이름 변경
• 빠른 수정

Clang 코드 모델 플러그인은 Clangd를 기반으로 C++에 대해 이러한 서비스 중 일부를 제공합니다.

Clang 코드 모델에 대해

Clang 프로젝트에는 C 언어 계열 소스 파일을 파싱하기 위한 라이브러리가 포함되어 있습니다. 경고 및 오류 마커를 통해 얻는 피드백은 컴파일러가 제공하는 것과 동일하며, 내장된 Qt Creator 코드 모델을 사용할 때처럼 불완전한 세트나 근사치가 아닙니다. Clang은 진단에 필요한 상세한 정보에 중점을 두며, 이는 예를 들어 코드에 오타가 있는 경우 매우 유용합니다. 우리는 LSP 서버를 구현하는 clangd 도구를 통해 이러한 라이브러리를 활용합니다.

Clang은 C++ 언어의 발전 추세를 꾸준히 따라가고 있습니다. 이 글을 작성하는 시점에서 Clang은 C++98/03, C++11, C++14, C++17, C89, C99, Objective-C 및 Objective-C++을 지원합니다.

단점으로는, 대규모 프로젝트의 경우 Clang을 코드 모델로 사용하는 것이 내장 코드 모델을 사용하는 것보다 속도가 느리다는 점입니다. Clang은 오브젝트 파일을 생성할 필요는 없지만, 소스 파일을 파싱하고 분석해야 합니다. STL만 사용하는 소규모 프로젝트의 경우 이 과정이 비교적 빠릅니다. 하지만 여러 파일을 포함하는 대규모 프로젝트의 경우, 단일 파일과 포함된 모든 파일을 처리하는 데 시간이 다소 걸릴 수 있습니다.

Clang 코드 모델 플러그인은 이제 내장된 C/C++ 코드 모델과 동일한 일부 기능을 제공합니다:

• 코드 자동 완성
• 구문 및 의미론적 강조 표시
• 진단
• 심볼 개요
• 툴팁
• 기호 추적
• 기호 이름 변경
• 기호의 사용 위치 찾기

대신 내장 코드 모델을 사용하려면, ‘ Preferences ’ > ‘ C++ ’ > ‘ clangd ’를 선택하고, ‘ Use clangd ’의 체크를 해제하십시오. 이 설정은 프로젝트 수준에서도 존재하므로, Clang 기반 서비스를 전반적으로 활성화한 상태에서 특정 프로젝트에 대해서만 비활성화하거나, 그 반대의 경우도 설정할 수 있습니다.

다음에 대해 Clang 진단 기능을 구성할 수 있습니다:

• Clang 코드 모델 (전역 또는 프로젝트 수준)
• Clang 도구 (전역 또는 프로젝트 수준)

Clangd 인덱싱

clangd 인덱스는 복잡한 구문에서도 참조 찾기, 커서 위치의 심볼 추적, 로케이터 사용과 같은 서비스에 대해 정확하고 완전한 결과를 제공합니다. 프로젝트를 열면 clangd가 소스 파일을 스캔하여 인덱스를 생성합니다. 대규모 프로젝트의 경우 이 과정에 다소 시간이 걸릴 수 있지만, 인덱스는 영구적으로 유지되며 재스캔은 증분 방식으로 이루어지므로, Qt Creator 를 닫았다가 다시 시작하더라도 데이터가 손실되지 않습니다.

전역 인덱싱을 일시적으로 비활성화하려면 Toggle Progress Details (1)을 선택한 다음, 진행률 표시줄에서 ‘ X ’를 선택하십시오.

기본적으로 Qt Creator 는 프로젝트당 하나의 clangd 프로세스를 실행합니다. 관련 프로젝트가 포함된 세션을 생성한 경우, 세션 내의 프로젝트를 단일 clangd 프로세스로 관리하도록 지정할 수 있습니다.

개요( Outline ) 보기의 문서 개요는 clangd의 문서 심볼 지원을 기반으로 하므로, 이전보다 더 신뢰할 수 있는 결과를 제공합니다.