이 페이지에서

Git 저장소에서 Qt 소스 가져오기

이 페이지에서는 공용 Git 저장소에서 Qt 소스를 가져오는 방법을 설명합니다. Git 저장소에는 최신 개발 브랜치 및 Qt 6의 릴리스 버전이 포함되어 있습니다.

또한 Qt 계정 (상용 사용자)을 통해 Qt Online Installer, 또는 다운로드.qt.io (오픈 소스 사용자)에서 Qt 소스를 받을 수 있습니다.

Git 서브모듈을 초기화할 때 init-repository 도구를 실행하려면 최신 버전의 Git 및 CMake 설명서가 필요합니다.

참고: 이 지침은 명령줄 도구 사용에 익숙하다고 가정합니다.

Qt 리포지토리 복제하기

Qt는 메인 qt5.git 리포지토리에 있는 여러 Git 서브모듈에서 개발 및 유지 관리됩니다. Git에서 Qt 소스를 가져오려면 명령줄을 통해 최상위 Git 리포지토리를 복제해야 합니다.

참고: Qt 5와 Qt 6는 동일한 저장소( qt5.git)를 공유하므로 Qt 6를 사용하더라도 Qt 5 저장소를 얻을 수 있습니다.

이 지침은 유닉스와 유사한 셸 구문을 사용합니다. Windows에서도 명령은 비슷합니다. 아래 명령은 현재 버전의 Qt 6을 qt 라는 디렉토리에 복제합니다.

git clone --branch v6.11.0 git://code.qt.io/qt/qt5.git qt

방화벽에 의해 git 프로토콜이 차단된 경우 HTTPS를 대신 사용하는 것을 고려하세요:

git clone --branch v6.11.0 https://code.qt.io/qt/qt5.git qt

복제 후 qt 디렉터리에는 설치 파일과 초기화되지 않은 Qt 서브모듈이 포함된 기본 Qt Git 리포지토리가 포함됩니다.

Qt 서브모듈 초기화하기

qt5.git 저장소에는 Qt 모듈이 Git 서브모듈로 포함되어 있습니다. 서브모듈을 초기화 및 복제하려면 최상위 디렉토리에서 init-repository 도구를 실행합니다.

./init-repository

Linux 환경이 없는 Windows에서는 init-repository.bat 을 대신 사용합니다.

init-repository.bat

init-repository 는 설치 파일을 복제하고 초기화하여 Qt 소스를 빌드합니다. 또한 리포지토리에는 패치 생성, 코드 테스트, 문서 생성에 도움이 되는 도구가 있습니다. 기여에 대한 자세한 내용은 Qt 기여하기 사이트를 참조하세요.

이미 같은 디렉터리에 Qt 저장소가 있는 경우 -f 을 전달하여 init-repository 이 서브모듈을 강제로 초기화하도록 할 수 있습니다.

./init-repository -f

Qt 특정 서브모듈 초기화하기

특정 Qt 모듈 세트만 필요한 경우 init-repository--module-subset 를 인자로 사용하여 최소한의 서브모듈 세트를 초기화합니다. 예를 들어, essential 을 인자로 지정하여 Qt Essentials 모듈만 초기화할 수 있습니다.

./init-repository --module-subset=essential

Qt 애드온의 경우 addon 을 대신 사용합니다.

./init-repository --module-subset=addon

동시에 여러 개의 하위 모듈을 선택할 수도 있습니다. 예를 들어 qtgrpcqtmqtt 서브 모듈을 필수 서브 모듈과 함께 초기화하려면 다음을 실행합니다:

./init-repository --module-subset=qtgrpc,qtmqtt

init-repository 도구는 항상 최소한의 서브모듈 세트를 초기화합니다.

자세한 내용은 -help 인수를 설정하여 init-repository 매뉴얼을 참조하세요:

./init-repository -help

복제 및 초기화 후

다음 단계는 Qt를 구성하고 빌드하는 것입니다. 자세한 내용은 Qt 소스 빌드하기 페이지를 참조하십시오.

© 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.