Python 3.15.1로 수업 프로젝트 가상 환경을 어떻게 만들까요? 2026 초보자 튜토리얼

터미널에서 수업 과제를 실행했는데, 필요한 라이브러리를 찾지 못하나요? 먼저 수업에서 지정한 파이썬 버전을 확인하고 프로젝트 전용 가상 환경을 만든 뒤, 그 안에 의존성을 설치해 과제를 실행하세요.

이 글은 첫 파이썬 과제를 준비하는 학생, 여러 프로젝트의 라이브러리가 섞여 곤란한 학습자, Windows에서 작성한 과제를 맥이나 원격 맥에서 이어 실행하려는 분을 위한 안내입니다.

마지막 업데이트: 2026년 10월 24일. Python 3.15.1 출시일과 가상 환경 명령은 공식 출시 정보 및 Python 3.15 가상 환경 문서를 기준으로 확인했습니다.

시작 전: 수업 버전과 내 파이썬 비교

Python 3.15.1은 공식 출시 페이지에 따르면 2026년 10월 21일에 공개된 버전입니다. 그렇다고 모든 수업 프로젝트에서 이 버전을 써야 하는 것은 아닙니다. 가상 환경은 만들 때 사용한 파이썬 인터프리터를 바탕으로 구성되므로, 다른 버전을 요구하는 수업이라면 먼저 그 요구를 따르세요. 가상 환경이 수업 지정 버전을 대신해 주지는 않습니다.

수업 안내문, 프로젝트 파일, 터미널을 차례로 확인하면 필요한 버전을 찾기 쉽습니다. 터미널에서는 아래 명령으로 현재 선택된 버전을 확인합니다.

python --version

맥이나 리눅스에서 python 명령이 인식되지 않으면 다음처럼 확인할 수 있습니다.

python3 --version

프로젝트 폴더에서 만드는 독립 환경

가상 환경은 과목마다 따로 쓰는 실험 책상과 같습니다. 한 책상에 한 수업의 도구를 놓으면, 다른 프로젝트의 라이브러리를 건드리지 않고 작업할 수 있습니다. Python의 venv는 프로젝트별 환경을 만들고 활성화하는 데 사용하는 기본 모듈입니다. 환경은 명령을 실행한 위치에 만들어지므로, 먼저 올바른 과제 폴더로 이동해야 합니다. Python 공식 venv 문서에 나온 생성 방식을 따르세요.

프로젝트 폴더에서 아래 명령을 실행합니다.

python -m venv .venv

맥이나 리눅스에서 파이썬을 python3으로 실행한다면 다음처럼 입력합니다.

python3 -m venv .venv

여기서 .venv는 환경을 저장할 폴더 이름입니다. 이미 같은 이름의 폴더가 있다면, 기존 환경을 덮어쓰거나 지우기 전에 그 폴더가 현재 프로젝트에서 쓰이는 것인지 확인하세요. 환경 폴더를 과제 코드와 함께 관리하더라도 다른 컴퓨터에 그대로 복사해 쓸 수 있다고 가정하면 안 됩니다.

활성화와 경로 확인: 플랫폼별 명령

가상 환경을 만들었다고 터미널이 자동으로 그 환경을 쓰는 것은 아닙니다. 활성화 명령은 운영체제와 셸에 따라 다릅니다. 아래 표에서 사용 중인 환경에 해당하는 행만 실행하세요. Windows에서 쓰는 명령과 실행 방법은 Python 공식 Windows 안내와 venv 활성화 설명을 참고할 수 있습니다.

활성화 후 프롬프트에 환경 이름이 표시되는지 확인합니다. 이어서 아래 명령을 실행해 실제 인터프리터 경로를 확인하세요.

python -c "import sys; print(sys.executable)"

출력 경로가 현재 프로젝트의 .venv 폴더 안을 가리키면 해당 터미널은 프로젝트 환경의 파이썬을 사용하고 있습니다. sys.executable은 현재 실행 중인 파이썬의 경로를 알려 주는 속성입니다. Python 공식 sys 문서에서 확인할 수 있습니다.

활성화가 되지 않으면 우선 프로젝트 폴더에서 명령을 실행했는지, 그리고 현재 터미널이 PowerShell인지 명령 프롬프트인지 확인하세요. macOS와 Windows의 명령을 섞어 입력하면 경로가 맞지 않습니다.

과제에 필요한 의존성만 설치

가상 환경에는 프로젝트에 필요한 라이브러리가 자동으로 들어 있지 않습니다. 수업 안내에서 지정한 패키지나 프로젝트의 의존성 파일을 먼저 찾으세요. 어떤 라이브러리를 설치해야 하는지 모른다면 임의로 패키지를 추가하기보다 강의 자료나 담당자의 안내를 확인하는 편이 안전합니다.

과제 폴더에 requirements.txt가 제공되면, 환경을 활성화한 터미널에서 다음 명령을 실행합니다.

python -m pip install -r requirements.txt

파일이 없고 수업에서 패키지 이름을 지정했다면 그 지침에 따라 설치합니다.

python -m pip install 패키지이름

설치 명령과 의존성 파일 형식은 pip 설치 안내 및 요구 사항 파일 형식 문서에서 확인할 수 있습니다. pip 사용법은 공식 사용자 안내도 참고하세요. 설치가 끝났다는 메시지만으로 과제 실행까지 확인된 것은 아닙니다.

중간 점검: 자주 막히는 지점

Python 3.15.1로 수업 프로젝트 가상 환경을 만들려면 어떻게 하나요?
먼저 수업에서 요구하는 파이썬 버전이 3.15.1인지 확인하세요. 해당 버전의 파이썬을 실행하는 터미널에서 프로젝트 폴더로 이동한 뒤 python -m venv .venv를 실행합니다. 다른 버전을 지정한 수업이라면 그 버전을 선택해야 합니다. 환경을 활성화하고 경로를 확인한 다음 의존성을 설치하세요.

파이썬 과제마다 환경을 따로 만들어야 하나요?
서로 다른 프로젝트에서 요구하는 라이브러리나 파이썬 버전이 다르면 프로젝트별 환경을 사용하는 것이 좋습니다. 한 과목의 여러 과제가 같은 프로젝트와 의존성을 공유한다면 같은 환경을 쓸 수 있습니다. 과제 파일 하나마다 무조건 새로 만들기보다, 어떤 코드와 라이브러리를 함께 관리할지 기준으로 정하세요.

터미널이 가상 환경의 파이썬을 쓰는지 어떻게 확인하나요?
활성화 표시를 확인한 뒤 python -c "import sys; print(sys.executable)"를 실행하세요. 결과 경로가 프로젝트의 .venv 아래인지 확인하면 됩니다. 코드 편집기에서 실행할 때만 라이브러리를 찾지 못한다면, 편집기가 터미널과 다른 인터프리터를 선택했는지도 살펴보세요.

가상 환경에 수업 라이브러리를 어떻게 설치하나요?
먼저 활성화한 환경에서 수업 안내에 적힌 패키지나 requirements.txt를 확인합니다. 파일이 있다면 python -m pip install -r requirements.txt로 설치할 수 있습니다. 파일이 없다면 수업에서 지정한 패키지 이름을 사용하세요. 설치 후 과제에서 실제로 가져오는 라이브러리를 불러와 실행해 봐야 합니다.

과제 실행으로 마지막 확인

프로젝트에서 요구하는 최소 실행 파일이나 과제의 시작 명령을 실행하세요. 확인할 것은 단순히 오류 메시지가 없는지가 아닙니다. 선택된 인터프리터가 프로젝트 환경을 가리키는지, 과제에서 쓰는 라이브러리를 불러오는지, 기대한 실행 결과가 나오는지를 각각 살펴봐야 합니다.

라이브러리를 찾지 못한다면 아래 순서로 확인하면 원인을 좁히기 쉽습니다.

• 현재 터미널에서 가상 환경을 활성화했는지 확인합니다.
• sys.executable 출력 경로가 프로젝트의 .venv를 가리키는지 확인합니다.
• 설치 명령을 실행한 터미널과 과제를 실행하는 터미널이 같은 환경인지 확인합니다.
• 수업에서 제공한 의존성 파일이나 패키지 이름을 다시 확인합니다.

환경을 새로 만들었더라도 수업에서 지정한 파이썬 버전이 다르면 과제 결과가 달라질 수 있습니다. 설치와 실행을 한 터미널에서 점검하고, 다른 편집기에서 실행한다면 편집기의 인터프리터 설정도 맞춰 주세요.

다른 컴퓨터와 맥에서 이어 쓰기

Windows에서 작업하던 프로젝트를 맥으로 옮길 때는 코드와 환경을 구분하세요. 과제 파일과 수업에서 요구하는 의존성 기록은 프로젝트에 맞춰 전달하되, .venv 폴더를 복사해 새 컴퓨터에서 그대로 쓸 수 있다고 기대하지 않는 편이 좋습니다. 대상 컴퓨터에서 수업 지정 파이썬을 확인하고, 그곳에서 가상 환경을 다시 만든 다음 의존성을 설치하세요.

맥에서 개발해야 하는 수업이라면 먼저 기존 컴퓨터에서 과제를 수행할 수 있는지 확인하세요. 파이썬 학습 자체에는 맥이 필수 조건이 아니며, Windows에서도 프로젝트를 작성하고 실행할 수 있습니다. 다만 수업에서 macOS 환경을 명시하거나 맥에서 결과를 확인해야 한다면 환경 차이를 따로 점검해야 합니다. 맥에서 인터프리터 경로를 확인하는 절차는 Mac Python 개발 환경 안내를 참고할 수 있습니다.

제출 전 실행 목록

• [ ] 수업에서 지정한 파이썬 버전을 확인했습니다.
• [ ] 프로젝트 폴더에서 전용 가상 환경을 만들었습니다.
• [ ] 운영체제와 셸에 맞는 명령으로 환경을 활성화했습니다.
• [ ] 인터프리터 경로가 프로젝트 환경을 가리키는지 확인했습니다.
• [ ] 수업에서 지정한 의존성만 설치했습니다.
• [ ] 과제 프로그램을 실행하고 필요한 기능을 확인했습니다.
• [ ] 다른 컴퓨터로 옮길 때 환경 폴더가 아니라 코드와 의존성 기록을 기준으로 준비했습니다.

현재 컴퓨터와 원격 맥 선택

Python 과제만 한다면 현재 Windows 컴퓨터나 개인 맥에서 시작하면 됩니다. Windows는 macOS 전용 작업을 그대로 확인할 수 없고, 컴퓨터에 설치 권한이 없으면 수업 환경을 구성하기 어려울 수 있습니다. 반대로 원격 맥은 네트워크 연결과 파일 이동을 고려해야 하며, Python을 배우는 모든 학생에게 필요한 선택은 아닙니다.

맥에서 과제를 확인해야 하지만 당장 기기를 구매하기 어렵다면 MacDate 원격 맥 이용 안내를 살펴볼 수 있습니다. 짧은 기간 동안 실제 macOS 환경에서 프로젝트를 점검하려는 경우에는 맥 구매와 임대 조건을 맥 미니 이용 요금 안내와 비교해 보세요. 수업에서 맥을 요구하지 않고 기존 컴퓨터로 과제를 실행할 수 있다면, 가상 환경을 올바르게 분리해 현재 기기를 사용하는 것으로 충분합니다.