맥 파이썬 개발 환경 설정: 2026 초보자 설치부터 실행까지

이번 주에는 수업에서 지정한 파이썬 버전을 먼저 확인하고, 그다음 공식 설치기나 Homebrew 가운데 하나를 골라 설치한 뒤 프로젝트별 가상 환경에서 코드를 실행하세요. 이 순서라면 초보자도 맥 파이썬 개발 환경 설정을 수업 조건에 맞게 시작할 수 있습니다.

맥에서 파이썬을 처음 배우는 학생은 설치부터 첫 실행까지 따라 할 수 있습니다.
이미 설치했지만 프로젝트마다 버전이 헷갈리는 학습자는 환경을 분리하는 방법을 확인하세요.
맥이 없고 수업에서 macOS를 요구한다면 원격 맥이 연습 조건에 맞는지도 살펴볼 수 있습니다.

설치 전에 수업의 버전과 파일부터 확인합니다

파이썬을 설치하기 전에 강의 안내에서 파이썬 버전, 편집기, 필요한 패키지 목록을 확인하세요. 과제에 requirements.txt 같은 의존성 파일이 있다면 파일 이름과 안내된 설치 방법도 기록해 둡니다. 최신 버전을 먼저 설치하는 것보다 수업과 프로젝트가 요구하는 환경을 재현하는 일이 중요합니다.

맥에는 운영체제나 다른 개발 도구가 사용하는 파이썬이 있을 수 있고, 사용자가 별도로 설치한 파이썬도 있을 수 있습니다. 터미널에서 python3을 실행한다고 해서 언제나 같은 설치본을 사용하는 것은 아닙니다. 파이썬 공식 문서도 맥에서 파이썬을 사용하는 방법과 설치 경로를 별도로 설명하므로, 공식 맥 사용 안내를 함께 확인하세요.

두 설치 방식은 모두 선택지가 될 수 있지만, 같은 맥에 둘 다 설치하면 터미널에서 어느 파이썬이 선택되는지 헷갈릴 수 있습니다. 처음이라면 한 가지 방식을 정하고, 설치 뒤 실행 파일 경로를 확인하는 편이 문제를 좁히기 쉽습니다. Homebrew를 처음 쓰는 경우에는 파이썬 설치 명령만 따로 찾기보다 공식 설치 문서의 현재 절차를 기준으로 진행하세요.

설치한 파이썬이 터미널에서 실행되는지 확인합니다

설치가 끝나면 터미널을 열고 아래 명령을 입력합니다.

python3 --version
which -a python3

첫 번째 명령은 실행되는 파이썬의 버전을 표시합니다. 두 번째 명령은 터미널이 찾을 수 있는 python3 실행 파일의 위치를 보여줍니다. 설치한 버전과 출력이 맞는지 확인하고, 여러 경로가 나온다면 수업에서 요구하는 파이썬을 실행하는지 살펴보세요. 명령을 찾을 수 없거나 다른 버전이 표시되면 설치를 반복하기 전에 터미널의 실행 경로와 설치 안내를 확인합니다.

파이썬 공식 문서는 대화형 해석기를 시작하고 종료하는 방법도 안내합니다. 터미널에서 python3을 입력했을 때 >>>가 나타나면 파이썬 코드를 직접 입력할 수 있습니다. 예를 들어 print("안녕하세요")를 입력하면 출력이 표시됩니다. 자세한 입력과 종료 방법은 공식 해석기 안내에서 확인할 수 있습니다.

파일로 실행하는 방법도 연습해 보세요.

mkdir python-practice
cd python-practice
printf 'print("첫 파이썬 실행")\n' > hello.py
python3 hello.py

터미널에 첫 파이썬 실행이 보이면 파일을 저장하고 실행하는 과정이 완료된 것입니다. 이후에는 편집기에서 파일을 수정하고 같은 방식으로 다시 실행하면 됩니다.

프로젝트마다 가상 환경을 따로 만듭니다

가상 환경은 프로젝트마다 따로 두는 작은 도구 상자와 같습니다. 한 과제에 필요한 패키지를 설치해도 다른 과제의 환경과 섞이지 않도록 도와줍니다. 파이썬 공식 문서의 venv 안내는 프로젝트별 환경을 만드는 방법을 설명합니다.

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

python3 -m venv .venv
source .venv/bin/activate

활성화된 뒤에는 보통 터미널 입력 줄 앞부분에 환경 이름이 표시됩니다. 환경 안에서 패키지를 설치하고 코드를 실행하면 해당 프로젝트의 도구 상자에 작업 내용이 들어갑니다. 환경을 나갈 때는 다음 명령을 입력합니다.

deactivate

수업에서 requirements.txt를 제공했다면 환경을 활성화한 다음 파일을 기준으로 설치합니다.

python -m pip install -r requirements.txt

pip는 파이썬 패키지를 설치하고 관리하는 도구입니다. 설치 방법은 파이썬 패키지 안내서의 가상 환경 설명과 pip 사용자 안내를 참고하세요. 의존성 파일의 문법과 지정 방법은 requirements 파일 안내에서 확인할 수 있습니다.

자주 묻는 질문

맥에서 설치한 뒤 첫 파이썬 코드는 어떻게 실행하나요?

터미널에서 python3 --version으로 실행 여부를 확인하고, 프로젝트 폴더에 파이썬 파일을 저장해 실행합니다. 예를 들어 hello.py를 만들었다면 python3 hello.py를 입력하면 됩니다. 설치 직후 명령을 찾을 수 없다면 재설치부터 하지 말고 which -a python3으로 터미널이 찾는 실행 파일을 확인하세요.

공식 설치기와 Homebrew 중 무엇을 선택해야 하나요?

수업이나 프로젝트가 설치 방법을 지정했다면 그 지침을 따르세요. 별도 요구가 없고 Homebrew를 사용해 본 적이 없다면 공식 macOS 설치 안내를 따라가는 편이 이해하기 쉬울 수 있습니다. 이미 Homebrew로 다른 개발 도구를 관리한다면 Homebrew 설치도 선택할 수 있습니다. 어떤 방식을 쓰든 설치 후 버전과 실행 경로를 확인해야 합니다.

수업에서 지정한 버전이 있다면 어떻게 맞추나요?

수업 문서와 프로젝트 파일에서 요구 버전을 먼저 확인한 뒤, 공식 다운로드 페이지나 Homebrew 문서에서 해당 버전을 지원하는 설치 절차를 확인하세요. 현재 설치된 파이썬이 수업 요구와 다르면 과제를 시작하기 전에 환경을 맞추는 것이 좋습니다. 정확한 설치 방법은 사용하는 설치 경로와 문서의 현재 안내를 기준으로 판단하세요.

프로젝트가 여러 개면 패키지 충돌을 어떻게 막나요?

각 프로젝트 폴더에 별도의 가상 환경을 만들고, 작업할 프로젝트의 환경만 활성화하세요. 패키지는 그 상태에서 설치하고, 프로젝트에 의존성 파일이 있다면 파일을 기준으로 설치합니다. 작업을 마친 뒤 deactivate로 환경을 나가면 됩니다. 전역 환경에 모든 패키지를 한꺼번에 설치하는 방식은 프로젝트 사이의 차이를 추적하기 어렵게 만들 수 있습니다.

기기 제한에 맞춰 연습 환경을 고릅니다

일반적인 파이썬 문법과 파일 처리 연습은 맥이 아니어도 가능합니다. 반면 수업이 macOS 전용 도구나 맥에서만 가능한 작업을 요구한다면, 현재 사용하는 컴퓨터에서 그대로 수행할 수 있는지 먼저 확인해야 합니다. 학교 기기에서 프로그램 설치가 막혀 있거나 당장 맥을 사용할 수 없다면 원격 맥은 선택 가능한 연습 방법입니다.

원격 환경을 고르기 전에 과제 파일을 내려받거나 올려야 하는지, 그래픽 화면이 필요한지, 외부 장치에 직접 연결해야 하는지 확인하세요. 이런 조건이 없고 수업이 파이썬 기초 위주라면 현재 사용할 수 있는 컴퓨터에서 시작하는 편이 더 간단할 수 있습니다. 맥 환경이 꼭 필요한 경우에는 화면 공유 연결 안내를 먼저 읽고, 이용 조건은 요금제 안내에서 확인할 수 있습니다.

업그레이드와 오류를 프로젝트 기준으로 관리합니다

파이썬이나 패키지를 업그레이드하기 전에는 수업과 기존 프로젝트가 새 버전에서도 동작하는지 확인하세요. 새 프로젝트를 시작할 때도 이전 과제의 설정을 그대로 복사하지 말고, 요구 버전과 의존성 파일을 다시 살펴보는 편이 안전합니다.

오류가 나면 전체 메시지를 저장하고 다음 항목을 순서대로 확인합니다.

• 현재 가상 환경이 활성화되어 있는지 확인합니다.
• python --version과 which python으로 프로젝트에서 쓰는 실행 파일을 확인합니다.
• 설치해야 할 패키지가 프로젝트의 의존성 파일에 있는지 확인합니다.
• 설치 안내와 실행 명령이 현재 프로젝트의 가상 환경을 기준으로 되어 있는지 대조합니다.

python3과 python은 터미널 설정과 환경에 따라 서로 다른 실행 파일을 가리킬 수 있습니다. 따라서 오류를 해결할 때는 명령 이름만 바꾸어 반복 실행하기보다, 현재 활성화된 환경과 실제 실행 경로를 함께 확인해야 합니다.

이번 주에는 수업 환경부터 맞춥니다

• [ ] 수업 문서에서 파이썬 버전과 편집기 요구사항을 확인합니다.
• [ ] 설치 방식이 지정되어 있는지 확인하고, 없다면 공식 설치기와 Homebrew 중 하나를 고릅니다.
• [ ] 터미널에서 버전과 실행 파일 경로를 확인합니다.
• [ ] 연습 프로젝트 폴더에 가상 환경을 만들고 활성화합니다.
• [ ] 첫 파이썬 파일을 실행하고, 수업의 의존성 파일이 있다면 그 파일을 기준으로 패키지를 설치합니다.
• [ ] 과제에 macOS 전용 조건이 있는지 확인해 현재 컴퓨터에서 가능한지 판단합니다.

파이썬 기초만 공부한다면 당장 맥을 구매할 필요는 없습니다. 다만 학교 컴퓨터에서 설치가 제한되거나 macOS 전용 과제를 수행해야 한다면, 구매에는 초기 비용과 기기 관리가 따르고 공용 컴퓨터에는 설치 권한 제한이 있을 수 있다는 점을 함께 따져야 합니다. 먼저 과제 조건을 확인한 뒤 원격 맥이 필요한 상황에 한해 PingMini의 연결 안내와 이용 조건을 살펴보세요. 수업 요구를 충족하는 로컬 환경이 이미 있다면 그대로 사용하고, macOS가 꼭 필요한 실습에만 원격 연습을 고려하면 됩니다.

자주 묻는 질문