본문 바로가기
파이썬(Python)

VSCode에서 Qt Designer 사용하기 – 설치부터 연동까지 완벽 가이드

by 정보오리 2025. 2. 20.

저번 시간에 이어 오늘은 파이썬(Python)에서 'Qt Designer'를 이용하여 GUI 프로그램을 간단히 하는 방법에 대해서 알아보자

 

PyQt(파이썬 그래픽 라이브러리)를 사용하면 Python으로 강력한 GUI 애플리케이션을 만들 수 있다.

하지만 기본적으로 Qt Designer는 별도로 실행해야 하므로, VSCode와 연동하면 개발 효율이 훨씬 높아진다.

이 글에서는 VSCode와 Qt Designer를 연동하는 방법을 단계별로 설명한다.

 

1. 사전 준비

본격적인 설정에 들어가기 전에 필요한 프로그램을 설치해야 한다.

필수 설치 프로그램

  1. Python (최신 버전) 설치
 

파이썬(Python) 맥북에서 설치하기

맥북에서 파이썬 설치 및 실행 방법맥북에서 파이썬을 설치하는 방법은 크게 두 가지가 있다.Homebrew를 이용한 설치공식 웹사이트에서 직접 설치아래에서 각 방법을 자세히 설명한다.1. Homebrew를

gotoinfo.tistory.com

 

  2. VSCode 설치 (아래글 참고)

 

파이썬 IDE 간편 설정가이드(vscode) 및 확장프로그램 추천

파이썬을 개발할 때는 IDE(통합 개발 환경) 를 활용하는 것이 효율적이다.대표적인 IDE로는 VS Code와 PyCharm이 있으며, 각각의 설치 및 설정 방법을 정리했다.1. VS Code에서 파이썬 설정하기1.1 VS Code

gotoinfo.tistory.com

 

 

 3. Qt Desinger 설치

 

초보자도 쉽게 따라하는 Qt Designer 설치 가이드

이 글은 Qt Designer의 설치 방법을 단계별로 설명한다. Qt Designer는 Qt 프레임워크를 활용하여 GUI 디자인을 시각적으로 편리하게 구성할 수 있는 도구이다. 주로 Qt Creator와 함께 사용되지만, 독립 실

gotoinfo.tistory.com

 

 

 4. PyQt5 라이브러리 설치

최신 버전은 PyQt6 도 있지만 여기서는 PyQt5 버전을 다루도로 하겠다.

 

 pip install pyqt5 <- 터미널에서 라이브러 설치

 

 파이썬에서 GUI 프로그래밍을 하기위한 필수 라이브러이다.

물론 'tkinter'같은 라이브러리도 있지만 qt desinger와 연동하기 위해서는 pyqt5가 필요하다.

 

1.2.3 단계는 이미 설치되었다면 스킵하면 된다.

 

 

2. 사전 준비

이제 qt desinger 를 실행하여 간단한 윈도우 화면에 버튼 하나를 만들어 보도록 하자.

좌측 메뉴중 PushButton 을 마우스로 드래그 하여 옮겨 놓으면 끝.

 

이후, 윈도우 화면 저장한다.

 

  파이썬 코드 작성(win01.py)

간단히 설명하면 다음과 같다.

1~4 라인은 참조할 라이브러리(패키지)

 

6라인은 앞서 저장한 ui 파일 위치이다

이건 없어도 되지만 개발자 스타일에 따라 편하게 하면 될거 같다.

 

8~ 20라인은 그대로 따라하면 되고

11라인만 개발 환경에 맞게 수정하면 된다.

ui_path 변수를 사용하지 않으려면

다음과 같이 수정하면 된다.

uic.loadUi("ui파일위치와 이름", self) <- 이렇게

예를 들면 /home/user/python/win01.ui 파일이 있다면

 

uic.loadUi("/home/user/python/win01.ui", self)

위와 같이 하된다.

 

 

마지막으로 파이썬 프로그램(win01.py) 실행하면 다음과 같은 화면 나온다.

다음에는 PushButton 을 누르면 메세지 박스가 화면에 표시되는 것을 해보도록 하겠다.

즉 PushButton을 누르면 개발자가 작성한 함수를 호출하는 것이다.

 

끝.