파이썬 독학을 결심하고 가장 먼저 마주치는 커다란 장벽이 바로 '환경 구축'과 '환경 변수(PATH) 설정'입니다. 공식 홈페이지에서 다운로드 버튼을 누르고 설치를 마쳤는데, 명령 프롬프트(터미널)에서 python을 입력하면 "알 수 없는 명령"이라거나 에러 메시지가 뜨면서 당황하는 입문자가 정말 많습니다.

저 역시 처음 코딩을 배울 때 설치만 하면 바로 코드 작성을 시작할 수 있을 줄 알았습니다. 하지만 컴퓨터가 파이썬이 어디 설치되어 있는지 찾지 못해 몇 시간 동안 인터넷 검색만 헤매던 경험이 있습니다. 오늘은 윈도우(Windows)와 맥(macOS) 운영체제별로 파이썬을 올바르게 설치하고, PATH 설정 에러를 한 번에 해결하는 방법을 알기 쉽게 정리해 드립니다.

1. 윈도우(Windows) 환경: 체크박스 하나가 결과를 바꾼다

윈도우 환경에서 파이썬을 설치할 때 발생하는 문제의 90% 이상은 설치 프로그램 첫 화면에서 시작됩니다.

윈도우 설치 단계별 가이드

  1. 파이썬 공식 웹사이트(python.org)의 Downloads 메뉴에서 최신 안정화 버전을 다운로드합니다.

  2. 다운로드한 .exe 설치 파일을 실행합니다.

  3. [가장 중요] 설치 창 맨 아래에 있는 "Add python.exe to PATH" 체크박스에 반드시 체크합니다.

  4. 체크를 완료한 후 상단의 "Install Now"를 클릭하여 설치를 진행합니다.

만약 이 체크박스를 누르지 않고 넘어가면, 컴퓨터는 파이썬이 어느 폴더에 설치되었는지 알지 못합니다. 이로 인해 명령 프롬프트(cmd)에서 파이썬을 실행할 수 없는 현상이 발생합니다.

이미 체크 없이 설치했다면? (PATH 수동 설정)

설치할 때 체크를 놓쳤다면 프로그램을 삭제하고 재설치하면서 체크하는 것이 가장 빠르고 안전합니다. 만약 수동으로 설정하고 싶다면 아래 순서를 따릅니다.

  • Windows 키 + S 입력 후 '시스템 환경 변수 편집' 검색

  • 하단의 '환경 변수' 버튼 클릭 -> '시스템 변수' 항목 중 Path 선택 후 '편집' 클릭

  • 파이썬이 설치된 경로(예: C:\Users\사용자명\AppData\Local\Programs\Python\Python3xx\)를 새로 추가하고 확인을 누릅니다.

2. 맥(macOS) 환경: 기본 파이썬과 최신 파이썬의 구분

macOS 이용자들이 자주 겪는 혼란은 맥 자체에 이미 이전 버전의 파이썬이 기본 탑재되어 있거나, 터미널 명령어가 다르게 동작하는 경우입니다.

맥 설치 및 터미널 설정 가이드

  1. 파이썬 공식 웹사이트에서 macOS용 .pkg 설치 파일을 다운로드하여 설치를 진행합니다.

  2. 맥의 터미널(Terminal) 앱을 열고 버전을 확인합니다.

  3. 맥에서는 기본 시스템 명령어와의 충돌을 피하기 위해 python 대신 python3를 입력해야 하는 경우가 많습니다.

터미널에 python3 --version을 입력했을 때 설치한 파이썬 버전이 정상적으로 출력된다면 환경 구축이 완료된 것입니다.

만약 터미널에서 python이라는 단어만으로 최신 파이썬을 실행하고 싶다면, 사용 중인 셸 프로필 파일(.zshrc 또는 .bash_profile)에 별칭(alias)을 추가해주는 작업이 필요합니다.

  • 터미널에 echo 'alias python="python3"' >> ~/.zshrc 입력

  • source ~/.zshrc 명령어로 변경 사항 적용

3. 설치 완료 후 정상 작동 검증하는 법

설치가 올바르게 되었는지 확인하는 가장 확실한 방법은 터미널이나 명령 프롬프트에서 직접 실행해 보는 것입니다.

  1. 윈도우: Win + R을 누르고 cmd를 입력해 명령 프롬프트를 엽니다. 맥: Command + Space를 누르고 터미널을 검색해 엽니다.

  2. 화면에 python --version (맥은 python3 --version)을 입력하고 엔터를 칩니다.

  3. Python 3.1x.x 형태로 숫자 버전이 제대로 나타나면 성공입니다.

  4. 이어서 python (또는 python3)을 입력하면 >>> 모양의 파이썬 대화형 프롬프트가 나타납니다. 여기서 print("Hello World")를 입력해 코드가 실행되는지 테스트해 보세요.

  5. 대화형 화면을 종료할 때는 exit()를 입력하면 됩니다.

 핵심요약

  • 윈도우 설치 시 첫 화면의 "Add python.exe to PATH" 체크박스를 반드시 선택해야 환경 변수 오류를 예방할 수 있습니다.

  • macOS 환경에서는 기본 명령어 충돌을 방지하기 위해 터미널에서 python3 명령어를 사용하는 것이 기본입니다.

  • 설치 후에는 명령 프롬프트나 터미널에서 python --version을 입력해 버전이 정상 출력되는지 검증해야 합니다.