Python / PyCharm 설치하는 방법
Windows에서 PyCharm을 설치하려면 JetBrains 공식 설치 파일을 실행한 뒤 Python 프로젝트와 인터프리터를 설정하면 됩니다. 현재 PyCharm은 통합 제품으로 제공되며 핵심 기능은 무료로 계속 사용할 수 있습니다. PyCharm 설치와 Python 코드의 실행 환경 설정은 별개이므로, 프로젝트를 만든 뒤 실제 실행까지 확인해야 합니다.
설치 전에 알아둘 제품 구성과 준비 사항
PyCharm은 코드 편집·실행·디버깅을 돕는 통합 개발 환경(IDE, Integrated Development Environment)입니다. 현재 제품 안내에서는 이전의 Community·Professional 구성을 통합했으며, 설치 시 제공되는 30일 Pro 체험이 끝나도 핵심 기능은 무료로 사용할 수 있다고 설명합니다. Pro 구독은 추가 기능을 계속 사용할 때 선택합니다.
아래는 PyCharm 2026.2 공식 문서의 Windows 설치와 로컬 Python 프로젝트를 기준으로 안내합니다. 설치 파일은 PC의 x64·ARM64 아키텍처에 맞게 선택하고, 공식 시스템 요구 사항에서 운영체제·메모리·저장 공간을 확인합니다. PyCharm을 구동하는 JetBrains Runtime은 포함되어 있어 별도로 Java를 설치할 필요는 없지만, Python 코드를 실행할 인터프리터는 필요합니다.
기존 Python이 있으면 그 실행 파일을 사용할 수 있습니다. 없으면 Windows의 프로젝트 생성 과정에서 제공되는 Python 다운로드·설치를 선택할 수 있습니다. 네트워크나 조직 정책으로 설치가 제한된 경우에는 허용된 경로에 Python을 준비하고 위치를 지정합니다.
공식 설치 파일을 내려받아 실행
- JetBrains PyCharm 다운로드 페이지에서 Windows와 PC 아키텍처에 맞는 설치 파일을 받습니다. 오래된 Community 다운로드 화면을 기준으로 별도 에디션을 찾을 필요는 없습니다.
- 다운로드한
.exe를 실행하고 설치 위치를 확인합니다. 변경할 이유가 없으면 제공되는 기본 위치를 사용합니다. - 설치 옵션을 아래 기준에 따라 고릅니다. 모든 항목을 반드시 체크해야 정상 작동하는 것은 아닙니다.
- 설치를 완료하고 시작 메뉴나 선택한 바로가기로 PyCharm을 실행합니다. 약관·개인정보 관련 화면이 나오면 내용을 확인하고 필요한 항목과 선택 항목을 구분합니다.
JetBrains는 여러 버전의 설치·업데이트·되돌리기 관리에 Toolbox App도 권장합니다. 공식 설치 문서에서 Toolbox 방식과 독립 설치 방식의 차이를 확인한 뒤 한 가지로 관리하면 설치 위치를 혼동하기 어렵습니다.
설치 옵션은 언제 선택하면 될까요?
| 옵션 | 역할 | 선택 기준 |
|---|---|---|
| 바탕 화면 바로가기 | IDE를 여는 아이콘 추가 | 시작 메뉴보다 바탕 화면 실행이 편할 때 |
| Open Folder as Project | 폴더의 우클릭 메뉴에 프로젝트 열기 추가 | 탐색기에서 작업 폴더를 자주 열 때 |
| .py 연결 | Python 파일의 기본 열기 프로그램 연결 | 다른 편집기 대신 PyCharm으로 열고 싶을 때 |
| Add launchers dir to the PATH | 터미널에서 IDE 실행기를 찾도록 설정 | 명령으로 IDE를 열 때만 필요에 따라 선택 |
IDE 실행기 경로를 PATH에 넣는 옵션은 Python 인터프리터를 설치하거나 Python 명령을 설정하는 옵션과 다릅니다. .py 연결 역시 파일을 여는 동작을 정할 뿐 프로젝트의 실행 환경을 대신하지 않습니다.
새 프로젝트와 프로젝트 전용 가상환경 생성
새 Python 프로젝트 만들기의 핵심은 소스 폴더와 실행 환경을 함께 지정하는 것입니다. 처음에는 웹 프레임워크용 템플릿 대신 일반 Python 프로젝트를 선택하면 추가 설정을 줄일 수 있습니다.
- 시작 화면의 New Project 또는 열린 IDE의 File → New Project를 선택합니다.
- 일반 Python 프로젝트에서 쓰기 가능한 새 작업 폴더를 지정합니다. 예를 들어 개인 문서 아래
python-practice처럼 용도가 드러나는 폴더를 사용합니다. - Project venv를 선택하고 Python version에서 프로젝트가 사용할 Python을 지정합니다. 필요한 버전이 없으면 제공되는 다운로드를 사용하거나 설치된 Python 실행 파일을 찾아 지정합니다.
- Create를 눌러 환경 생성이 끝날 때까지 기다립니다. 이 방식은 프로젝트 루트의
.venv에 가상환경을 만듭니다.
가상환경은 프로젝트별 패키지를 분리하는 실행 환경입니다. 이미 준비한 환경이 있다면 Custom environment에서 기존 Python 환경을 선택할 수 있습니다. 기존 환경을 쓰려는 경우 새로 만들기로 덮어쓰지 말고 해당 실행 파일을 선택합니다. Windows의 프로젝트 가상환경 실행 파일은 보통 .venv\Scripts\python.exe입니다.
첫 Python 파일을 실행해 확인
- 왼쪽 Project 창에서 프로젝트 루트를 우클릭하고 New → Python File을 선택해
hello.py를 만듭니다. 자동 생성된 예제 파일이 있다면 그 파일의 내용을 교체해도 됩니다. - 다음 전체 코드를 저장합니다.
def total_price(price, quantity):
return price * quantity
print("Hello, PyCharm!")
print(total_price(20, 7))- 편집기에서 우클릭해 Run 'hello'를 선택합니다. Windows 기본 키맵에서는 Ctrl+Shift+F10으로 현재 파일을 실행할 수도 있습니다.
- Run 도구 창에서 다음 두 줄과 오류 없이 끝났는지 확인합니다.
Hello, PyCharm!
140첫 프로젝트 실행 안내의 메뉴를 기준으로 설명한 절차입니다. 메뉴 이름과 단축키는 버전·키맵·표시 언어에 따라 달라질 수 있습니다. 위 Python 예제의 출력은 Python 3.12.14에서 실행해 확인했으며, 설치 화면 전체를 직접 시험한 기록으로 해석할 범위는 아닙니다.
실행 환경이나 패키지가 맞지 않을 때
설치가 끝났어도 인터프리터가 없거나 다른 환경을 선택하면 실행에 실패할 수 있습니다. Settings → Python → Interpreter에서 프로젝트 실행 파일을 확인합니다. Windows에서는 Ctrl+Alt+S로 설정을 열 수 있습니다. 목록에 없으면 Add Interpreter → Add Local Interpreter로 새 환경을 만들거나 기존 실행 파일을 지정합니다. 자세한 분기는 인터프리터 설정 문서를 참고합니다.
- Invalid environment: 경로의 실행 파일이 실제로 있는지, 해당 Python 버전이 지원되는지 확인합니다.
- ModuleNotFoundError: 패키지를 설치한 Python과 프로젝트가 선택한 Python이 같은 환경인지 확인합니다. IDE를 다시 설치하기 전에 프로젝트 환경의 패키지 상태를 확인합니다.
- 다른 파일이 실행됨: 실행 구성과 선택된 스크립트를 확인하고, 실행할 파일의 우클릭 메뉴에서 다시 실행합니다.
- 환경 생성 실패: 작업 폴더의 쓰기 권한, 기본 Python 경로, 다운로드 연결을 확인합니다. 원인을 모른 채 전체 IDE를 관리자 권한으로 실행하는 것을 기본 대책으로 삼지 않습니다.
설치를 되돌리거나 제거하는 방법
Toolbox로 설치했다면 해당 PyCharm 인스턴스의 메뉴에서 버전 관리 또는 Uninstall을 사용합니다. 독립 설치했다면 Windows 설정의 앱 목록에서 PyCharm을 찾아 제거합니다. 정확한 경로와 남는 설정 파일은 공식 제거 안내에서 확인할 수 있습니다.
IDE 제거와 프로젝트 소스 삭제는 별개의 작업입니다. 작성한 코드와 필요한 프로젝트 설정은 먼저 백업하고, 재사용할 설정·가상환경·소스를 구분해 보관합니다. 설정 폴더까지 정리하려면 필요한 것이 없는지 확인한 뒤 해당 설치 버전의 위치만 대상으로 합니다.
