4강. PyCharm 시작 파일 설정

1. 시작 파일이란?
Python 프로젝트에는 여러 개의 `.py` 파일이 있을 수 있습니다.
예를 들어 프로젝트 구조가 다음과 같다고 가정합니다.
my_project/
├── main.py
├── welcome.py
├── calculator.py
└── .venv/
이때 PyCharm은 사용자가 어떤 파일을 실행하려는지 알아야 합니다.
예를 들어 `main.py`를 실행할 수도 있고, `welcome.py`를 실행할 수도 있습니다.
이 중에서 실제로 실행해야 하는 파일은 보통 `main.py`입니다.
따라서 PyCharm에서는 `main.py` 과 같은 실행할 시작 파일을 설정해야 합니다.
2. Run/Debug Configurations 란?
한국어로 표현하면 다음과 같습니다.
실행/디버그 구성
Run/Debug Configuration은 코드를 실행, 디버그, 테스트할 때 사용하는 설정 모음입니다. 이 설정에는 어떤 파일을 실행할지, 어떤 Python 인터프리터를 사용할지, 어떤 실행 옵션과 환경 변수를 사용할지가 포함됩니다.
쉽게 말하면:
PyCharm에게 “이 프로젝트를 실행할 때 이 파일을 이 Python 환경으로 실행해라”
라고 알려주는 설정입니다.
Run/debug configurations | PyCharm Documentation
Run/debug configurations | PyCharm
www.jetbrains.com
3. 시작 파일 설정 방법
1. Run/Debug Configurations 열기

PyCharm 상단 메뉴에서 다음 경로로 이동합니다.
Run > Edit Configurations
또는 오른쪽 위 실행 버튼 근처의 설정 메뉴에서 Edit Configurations를 선택합니다.
2. Python 실행 구성 추가

왼쪽 상단의 `+` 버튼을 누른 뒤 다음을 선택합니다.
Python
3. 실행 이름 설정

`Name` 항목에는 실행 구성을 구분하기 쉬운 이름을 입력합니다.
예시:
main 실행
또는:
Run main.py
이 이름은 실제 파일명이 아니라, PyCharm 안에서 실행 설정을 구분하기 위한 이름입니다
4. 시작 파일 지정

가장 중요한 실행할 Python 파일을 선택합니다.
/home/user/my_project/main.py
`Script` 항목은 실행할 시작 파일인 Python 스크립트 경로 또는 모듈 이름을 지정하는 곳입니다.
(선택 사항) 다중 실행 체크
프로그램을 여러 개 동시에 실행해 보는 것이 목적일 때만 체크합니다.
PyCharm에서 같은 실행 설정을 여러 번 동시에 실행할 수 있게 하는 옵션입니다.

예를 들어 main.py 실행 설정이 있다고 가정합니다.
`Allow multiple instance`s가 꺼져 있으면, main.py가 이미 실행 중일 때 다시 실행 버튼을 누르면 PyCharm이 보통 이렇게 묻습니다.
이미 실행 중인 프로그램을 중지하고 다시 실행할까요?
반대로 Allow multiple instances를 체크하면, 기존 실행을 멈추지 않고 같은 프로그램을 하나 더 실행할 수 있습니다.
5. 테스트

위에서 설정한 실행/디버그 구성 스크립트 파일명을 선택하고, 시작 버튼을 눌러 실행을 확인합니다.