VS Code에서 Qt 개발 환경 구축 가이드

VS Code에서 Qt 프로젝트를 개발하려면 Qt Language Server 모듈이 설치되어 있어야 한다.

Qt Language Server는 VS Code에서 Qt 프로젝트 개발을 원활하게 지원하는 도구로, 코드 자동 완성, 문법 검사, 정의 이동, 코드 탐색 등의 기능을 제공한다.

이를 통해 Qt 관련 코드를 보다 효율적이고 편리하게 작성할 수 있다.

 

우선 qt 설치 경로의 MaintenanceTool.exe 를 실행하여 Qt Language Server가 설치되어 있는지 확인하고 없다면 추가로 설치한다.

 

1. Qt Language Server 확인 및 설치

우선, Qt Language Server가 설치되어 있는지 확인한다.

 

설치 확인 방법

Qt가 설치된 디렉터리로 이동

기본 설치 경로:
Windows: C:\Qt
Linux: ~/Qt
macOS: /Users/[사용자이름]/Qt

 

MaintenanceTool.exe 실행

 

 

2. VS Code 확장팩 설치

Qt 프로젝트를 VS Code에서 사용할 수 있도록 필요한 확장팩을 설치한다.

설치해야 할 확장팩

 

 

3. Qt 설치 위치 등록

VS Code에서 Qt를 인식할 수 있도록 Qt 설치 경로를 등록한다.

 

등록 방법

1. VS Code에서 명령 팔레트 (Ctrl + Shift + P) 실행
2. Qt: Register Qt Installation 입력 후 실행
3. Qt 설치 경로를 입력
4. 예시: C:/Qt/
   - Qt Online Installer를 사용했다면 기본 경로는 C:/Qt/입니다.

4. Qt 프로젝트 환경 설정

Qt 프로젝트를 CMake를 이용해 빌드할 경우 몇 가지 추가 설정이 필요하다.

1. CMake Kit 설정
2. VS Code에서 Qt 프로젝트 폴더 열기
3. 명령 팔레트 (Ctrl + Shift + P)에서
4. CMake: Select a Kit 실행
5. 사용할 Qt Kit 선택 (예: Qt6-6.8.2-msvc2022_64)

 

 

 

5. 프로젝트 빌드 및 실행

CMake: Build

CMake: Run without Debugging

명령으로 프로젝트를 빌드하고 실행할 수 있다.

 

 

 

Visual Studio가 Qt Creator보다 더 익숙해서 설정 방법을 알아봤다. 물론 Qt Visual Studio Tools 확장팩을 활용하면 Visual Studio에서도 작업 환경을 구성할 수 있지만, MacOS에서는 VS Code가 더 간편해 보여 이를 조사해 보았다.
다만, VS Code에서 실행할 때 헤더 파일, 소스 파일, 폼 파일이 자동으로 분류되지 않아 직접 폴더를 생성하고, CMake에서 경로를 수동으로 지정해야 하는 번거로움이 있다는 점이 아쉬웠다. (추가 확장팩이 혹시 있을까..?)