파이썬 설치된 버전 확인하는 방법과 명령어 설정하기

파이썬을 설치했는데 python을 입력하면 동작하지 않거나, 이상한 버전이 실행된 적 있으신가요? 특히 macOS나 리눅스 환경에서는 python이 Python 2를 가리키는 경우도 많아, 개발자에게는 혼란이 생기기 쉽습니다.

이번 글에서는 현재 내 컴퓨터에 설치된 Python 버전 확인 방법, 그리고 명령어(python, python3)를 올바르게 설정하는 방법을 단계별로 정리해드립니다.

Windows, macOS, Linux 각 운영체제별로 설명하며, 실습 가능한 명령어도 함께 제공하니 끝까지 따라오시면 Python 개발 환경 이해에 큰 도움이 될 거예요.

핵심 요약

Python이 시스템에 설치되어 있는지, 어떤 버전이 설치되어 있는지는 다음 명령어로 확인할 수 있습니다.

python --version
python3 --version

현재 시스템에 설치된 파이썬 버전이 표시됩니다.

Python 3.10.8

만약 다음과 같이 Python 2가 출력된다면, python 명령어가 아직 Python 3로 연결되지 않은 상태입니다.

Python 2.7.16

운영체제	`python` 명령어	`python3` 명령어	설명
Windows (10 이상)	Python 3로 연결됨	동작 안 할 수도 있음	Microsoft Store 자동 연동
macOS	기본은 Python 2	Python 3 별도 설치 필요	수동 설정 필요
Ubuntu/Linux	Python 2일 가능성 있음	Python 3 기본 제공	`python-is-python3` 패키지로 연결 가능

터미널에서 아래 명령어를 입력하면 python을 python3로 연결할 수 있습니다. 단, 이 설정은 터미널을 종료하면 사라집니다.

alias python=python3

이를 영구적으로 설정하려면 다음의 명령어를 입력하면 됩니다. 만약, bash 사용자라면 .bashrc 또는 .bash_profile에 추가하세요.

echo 'alias python=python3' >> ~/.zshrc
source ~/.zshrc

sudo apt install python-is-python3

이 패키지를 설치하면 python 명령어가 자동으로 python3에 연결됩니다.

Windows에서는 py 명령어를 사용하면 다양한 버전의 Python을 쉽게 실행할 수 있습니다.

예:

py -3.11 --version

Q1. python 입력했더니 Python 2가 실행됩니다. 어떻게 바꾸나요?: macOS/Linux에서는 alias python=python3 설정을 하거나 pyenv를 사용할 수 있습니다. Ubuntu에서는 python-is-python3 패키지를 설치하면 python 명령어가 자동으로 Python 3를 가리키게 됩니다.
Q2. python3과 python을 둘 다 써도 되나요?: 가능하지만 운영체제에 따라 기본 연결이 다를 수 있습니다. 시스템에서는 python3 사용이 안전하며, 가상환경 안에서는 python이 해당 환경을 자동으로 가리키기 때문에 python만 사용해도 괜찮습니다.
Q3. Windows에서는 어떤 명령어를 쓰는 게 좋나요?: Windows에서는 py 명령어가 기본입니다. 예를 들어 py -3.10 또는 py -3.11 --version처럼 원하는 버전을 직접 실행할 수 있습니다. 가상환경 생성 시에는 py -3.10 -m venv venv처럼 사용할 수 있습니다.

설치된 Python 버전은 python --version, python3 --version으로 확인합니다.
운영체제에 따라 python이 Python 2를 가리킬 수 있으므로 명령어 설정이 중요합니다.
macOS/Linux는 alias나 pyenv, Ubuntu는 python-is-python3, Windows는 py 명령어로 조정 가능합니다.