Qt 설정
Qt 설정을 확인하고 변경하려면 Command Palette 로 이동하여 ‘ Qt: Open Qt Extension settings ’을 선택하십시오.
설정에서 변수 사용
VS Code용 Qt 확장 프로그램은 Qt 설정에서 변수 대입을 지원합니다. 사용 가능한 변수에 대해서는 다음 변수 참조를 참조하십시오.
| 변수 | 설명 |
|---|---|
${userHome} | 사용자의 홈 디렉터리로 확장됩니다. |
${workspaceFolder} | 현재 작업 공간의 루트 디렉터리로 이어지는 전체 경로로 확장됩니다. 경로 앞에 이 변수를 붙여 현재 작업 공간에 상대적인 Qt 설치 경로나 QML Language Server 실행 파일의 경로를 지정할 수 있습니다. 예를 들어, 작업 공간의 일부로 Yocto SDK와 해당 Qt 버전을 사용하는 경우입니다. |
Qt C++ 설정
C++ 언어에 대한 설정입니다.
| 설정 | 설명 |
|---|---|
| Disable Auto Kit Generation On Open | VS Code 시작 시 cmake-kits.json 의 자동 검색 및 업데이트를 비활성화합니다. 키트를 수동으로 관리하거나 cmake-kits.json 를 버전 관리 하에 두는 경우 유용합니다. |
| Do Not Ask for CMake Path | CMake Tools가 PATH 환경 변수를 검색하여 CMake의 위치를 추측할 수 있도록 합니다. |
| Do Not Warn Missing Source Dir | 키트에서 소스 디렉터리를 감지할 수 없다는 경고 메시지를 숨깁니다. 예를 들어, vcpkg로 Qt를 설치한 경우 이러한 현상이 발생할 수 있습니다. 자세한 내용은 Qt 애플리케이션 디버깅을 참조하십시오. |
| Do Not Warn Outdated CMake Tools | CMake Tools 확장 프로그램 버전이 너무 오래되어 프리셋을 지원하지 못한다는 경고를 숨깁니다. |
Qt Core 설정
Qt 확장 기능의 공통 기능에 대한 설정입니다.
| 설정 | 설명 |
|---|---|
| Additional Qt Paths | Qt 설치 위치를 찾기 위해 qtpaths 또는 qmake 실행 파일의 경로를 추가합니다. 자세한 내용은 '기타 설치'를 참조하십시오. |
| Default Project Directory | 새 프로젝트를 생성할 때 기본적으로 표시되는 폴더의 경로를 설정합니다. 자세한 내용은 ‘Qt 프로젝트 생성’을 참조하십시오. |
| Do Not Ask for Default Qt Installation Root | Qt Installation Root 의 값 설정에 관한 안내 메시지를 숨깁니다. |
| Do Not Ask for VCPKG | vcpkg 에 대한 CMake 키트 생성에 관한 안내 메시지를 숨깁니다. 자세한 내용은 '자동 등록'을 참조하십시오. |
| Enable QRC Editor | QRC 파일을 편집할 때 QRC 편집기를 사용할지, 아니면 기본 텍스트 편집기를 사용할지 여부를 지정합니다. 자세한 내용은 QRC 파일 편집을 참조하십시오. |
| Open Online Documentation in External Browser | 기본 브라우저에서 Qt 문서를 엽니다. 자세한 내용은 Qt 문서 읽기를 참조하십시오. |
| Qt Installation Root | Qt를 설치한 폴더의 경로입니다. 자세한 내용은 '자동 등록'을 참조하십시오. |
| Show Welcome Page On Activation | 확장 프로그램이 시작될 때 'VS Code용 Qt 확장 프로그램' Welcome 페이지를 표시할지 여부입니다. 자세한 내용은 시작하기를 참조하십시오. |
QML 설정
QML 코드 작성 및 미리 보기를 위한 설정입니다.
QML 미리 보기 설정
QML Live 미리보기에 대한 설정입니다. 자세한 내용은 ‘ Qt Quick 애플리케이션 미리보기’를 참조하십시오.
| 설정 | 설명 |
|---|---|
| Additional Build Dirs | QML 미리 보기 중에 QRC 파일을 검색할 추가 빌드 디렉터리입니다. 이 설정은 빌드 디렉터리가 작업 공간 외부에 있을 때 유용합니다. |
| Args | 명령 팔레트에서 애플리케이션을 시작할 때 애플리케이션에 전달할 기본 명령줄 인수입니다. |
QML Profiler 설정
QML Profiler 에 대한 설정입니다. 자세한 내용은 QML 코드 프로파일링을 참조하십시오.
| 설정 | 설명 |
|---|---|
| Args | QML Profiler 를 시작할 때 애플리케이션에 전달할 추가 명령줄 인수입니다. |
| Custom Trace Viewer Exe Path | QML Profiler 를 설치한 폴더의 경로입니다. |
QML Language Server 설정
설정 QML Language Server. 자세한 내용은 QML Language Server 켜기를 참조하십시오.
| 설정 | 설명 |
|---|---|
| Do Not Ask for Qmlls Download | QML Language Server 다운로드에 대한 안내 메시지를 숨깁니다. |
| Additional Import Paths | 지정된 폴더에서 QML 모듈을 찾고, QML Language Server 을 시작할 때 -I 명령을 사용하여 해당 모듈에 대한 import 문을 추가합니다. 수입 경로를 추가하려면 “ Add Item ”를 선택하십시오. |
| Custom Args | Add Item 을 선택하면 기본 인수를 사용하는 대신 사용자 지정 QML Language Server 인수를 설정할 수 있습니다. |
| Custom Docs Path | QML Language Server 문서를 설치한 폴더의 경로입니다. 자세한 내용은 Qt 문서 읽기를 참조하십시오. |
| Custom Exe Path | QML Language Server 를 설치한 폴더의 경로입니다. |
| Run QML Language Server when activating an extension | 확장 기능을 활성화할 때 QML Language Server 를 켭니다. |
| Handle LSP Trace | QML Language Server 에서 트레이스 출력을 수집합니다. |
| Use No CMake Calls | --no-cmake-calls 옵션을 사용하여 QML Language Server 에서 시작하는 자동 CMake 빌드를 비활성화합니다. |
| Use QML Import Path Env Var | QML_IMPORT_PATH 옵션을 사용하여 QML 모듈을 찾습니다. QML Language Server 을 시작할 때 -E 인수를 추가하려면 이 설정을 켜십시오. |
| Verbose Output | QML Language Server 의 상세 출력 정보를 표시합니다. |
Qt for Python 설정
Qt for Python 를 사용하여 개발하기 위한 설정입니다. 자세한 내용은 Python 개발을 참조하십시오.
| 설정 | 설명 |
|---|---|
| Do Not Warn About Old Style Projects | 프로젝트에서 pyproject.toml 파일 대신 .pyproject 구성 파일을 사용한다는 경고 메시지를 숨깁니다. 새 프로젝트의 경우 TOML 기반 구성 파일을 사용하는 것이 권장됩니다. 자세한 내용은 Qt for Python: pyside6-project를 참조하십시오. |
Qt UI 설정
.ui 파일 처리를 위한 설정입니다. 자세한 내용은 위젯 기반 UI 설계를 참조하십시오.
| 설정 | 설명 |
|---|---|
| Custom Widgets Designer Exe Path | Qt Widgets Designer 를 설치한 폴더의 경로입니다. |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
