Clangd

Clang 프로젝트에는 C 언어 계열 소스 파일을 구문 분석하고 자세한 진단을 제공하는 라이브러리가 있습니다. clangd 인덱스는 코드 완성과 같은 서비스에 대해 정확하고 완전한 결과를 제공합니다.

clangd에 대한 환경설정을 설정하려면 다음과 같이 하세요:

1. 환경설정 > C++ > Clangd > Use clangd 을 선택합니다.

   

2. Path to executable 에 clangd 버전 14 이상의 경로를 입력합니다.
3. Background indexing 필드에서 Off 을 선택하여 기본으로 사용되는 인덱서보다 빠르지만 정확도는 떨어지는 기본 제공 인덱서를 사용합니다. 글로벌 심볼 검색 시 결과의 정확성 또는 속도 중 어느 쪽이 더 중요한지에 따라 인덱싱 우선순위를 설정하세요.
4. Per-project index location 에서 각 프로젝트의 색인 파일을 저장할 폴더를 선택합니다. compile-commands.json 파일도 이 폴더에 저장됩니다.
5. Per-session index location 에서 각 세션의 인덱스 파일을 저장할 폴더를 선택합니다.
6. Header/source switch mode 에서 헤더 파일과 소스 파일 간 전환을 위한 C/C++ 백엔드를 선택합니다. clangd 구현은 기본 제공 코드 모델보다 더 많은 기능을 가지고 있지만, 오탐을 찾는 경향이 있습니다. Try Both 는 기본 제공 코드 모델이 아무것도 찾지 못하면 clangd를 사용합니다.
7. 기본적으로 clangd는 사용하지 않는 모든 코어를 사용하려고 시도합니다. Worker thread count 에서 사용할 고정 코어 수를 설정할 수 있습니다. 백그라운드 인덱싱도 이 많은 작업자 스레드를 사용합니다.
8. 심볼을 완성할 때 헤더 파일을 삽입하려면 Insert header files on completion 을 선택합니다.
9. 헤더 파일을 편집할 때 헤더 파일을 포함하는 모든 소스 파일을 다시 구문 분석하려면 Update dependent sources 을 선택합니다. 헤더 파일이 많은 소스 파일에 포함된 경우 CPU 부하가 과중해질 수 있습니다. 헤더 파일을 저장할 때 소스 파일만 다시 구문 분석하려면 이 옵션을 선택 취소합니다.
10. 코드 완성 중에 중요한 결과를 자주 놓치는 경우 Completion results 수를 설정합니다. 완료 결과 수에 대한 제한을 없애려면 0으로 설정하세요. 이 값을 0 또는 매우 높게 설정하면 코드 완성 속도가 느려질 수 있습니다.
11. Completion ranking model 에서 완성 제안의 순위를 매기는 데 사용할 클랭드 모델을 선택합니다. 이렇게 하면 선택 목록에서 순서가 결정됩니다. Decision Forest 모델(Default)은 사전 학습된 머신 러닝의 결과이며 일반적으로 수작업으로 만든 Heuristic 모델보다 더 나은 결과를 제공합니다. 완성 제안이 코드 베이스에 대한 기대치에서 너무 많이 벗어난 경우 후자를 선택하세요.
12. Document update threshold 에서 Qt Creator 이 문서 변경 내용을 서버로 보내기 전에 대기할 시간을 지정합니다. 대기하는 동안 문서가 다시 변경되면 이 시간 제한이 재설정됩니다.
13. 큰 파일을 무시하여 구문 분석 속도를 높이려면 Ignore files greater than 을 선택합니다. 확인란 옆의 필드에 구문 분석할 파일의 최대 크기를 지정합니다.
14. Diagnostic configuration 필드에는 수행할 Clang 검사가 표시됩니다. 필드의 값을 선택하여 수행할 검사를 선택하고 편집합니다.
15. Add 을 선택하여 인덱싱에 단일 clangd 프로세스를 사용해야 하는 세션을 선택합니다.

Clang 검사

Diagnostic configuration 필드 값을 선택하면 Diagnostic Configurations 대화 상자가 열리고, 여기서 수행할 검사를 선택하고 편집할 수 있습니다.

기본 제공 검사를 사용하는 것 외에도 Copy 을 선택하여 사본을 만들고 필요에 맞게 사본을 편집할 수 있습니다.

• Build-system warnings 빌드 시스템에서 지정한 경고를 표시합니다.
• Checks for questionable constructs -Wall 및 -Wextra 검사를 결합하여 쉽게 피할 수 있는 의심스러운 구조와 몇 가지 추가 문제를 확인합니다.

Clang 검사는 -W 로 시작합니다. 각 검사에는 -Wno 로 시작하는 네거티브 버전도 있습니다.

일부 옵션은 다른 옵션을 켠다는 점에 유의하세요. 자세한 내용은 경고를 요청하거나 억제하는 옵션 또는 GCC 또는 Clang 매뉴얼 페이지를 참조하세요.