Harnessing the Power of Open Source with Ubuntu

Ubuntu에서 파이썬 버전을 확인하고 전환하는 방법: 개발자를 위한 완전 가이드

개발 환경 설정
目次

1. Introduction

Ubuntu에서 Python을 사용할 때, Python 버전 관리가 중요한 작업이 됩니다.
Python은 자주 새로운 릴리스를 받으며, 개발 환경에 따라 다른 버전을 사용할 필요가 있을 수 있습니다.

그러나 Ubuntu에는 여러 Python 버전이 설치되어 있을 수 있으며, 다음과 같은 상황이 발생합니다:
“현재 Python 버전을 확인하고 싶다”
“특정 버전을 사용하고 싶다”
“Python 버전을 전환하고 싶다”
이러한 상황은 꽤 자주 발생합니다.

이 기사는 Ubuntu에서 Python 버전을 확인하고, 변경하고, 전환하는 방법을 자세히 설명합니다.
명령어 예시를 포함하여 초보자도 쉽게 따라할 수 있습니다. 끝까지 읽어보세요.

2. Ubuntu에서 Python 버전 확인 방법【지금 해보세요!】

먼저, Ubuntu에 현재 설치된 Python 버전을 확인하는 방법을 살펴보겠습니다.

2.1 가장 쉬운 방법 (1초 만에 확인)

Ubuntu에서 Python 버전을 확인하는 가장 간단한 방법은 터미널에서 다음 명령어를 실행하는 것입니다:

python3 --version

다음 명령어를 사용해도 동일한 결과를 얻을 수 있습니다:

python3 -V

예시:

$ python3 --version
Python 3.10.6

이 명령어는 현재 Python 버전을 표시합니다.

2.2 python --version과 python3 --version의 차이

Ubuntu에서 python 명령어는 Python 2를 가리킬 수 있습니다.
따라서 python3 --version을 사용하는 것이 권장됩니다.

python이 설치되어 있는지 확인하려면 다음을 실행하세요:

python --version

Command 'python' not found가 표시되면 Python 3만 설치되어 있다는 의미일 가능성이 큽니다.

2.3 상세 버전 정보 확인

더 자세한 정보를 원하시면 다음을 실행하세요:

python3 -VV

예시:

$ python3 -VV
Python 3.10.6 (main, Jan 16 2024, 11:25:20) [GCC 11.2.0]

이 명령어는 컴파일에 사용된 GCC 버전과 빌드 날짜 등의 세부 정보를 보여줍니다.

2.4 스크립트 내부에서 Python 버전 확인

스크립트 내부에서 Python 버전을 확인하려면 sys 모듈을 사용하세요:

import sys
print(sys.version)
print(sys.version_info)

예시:

$ python3 script.py
3.10.6 (main, Jan 16 2024, 11:25:20) [GCC 11.2.0]
sys.version_info(major=3, minor=10, micro=6, releaselevel='final', serial=0)

sys.version_info를 사용하면 버전의 각 요소(주요, 부수, 마이크로)를 숫자로 얻을 수 있습니다.

3. Python 버전 변경 또는 관리 방법【시스템 기본값 설정】

Ubuntu에는 여러 Python 버전이 설치되어 있을 수 있습니다.
이 섹션에서는 시스템 전체 기본 Python 버전을 변경하는 방법을 설명합니다.

3.1 설치된 Python 버전 확인

설치된 Python 버전을 확인하려면 다음을 실행하세요:

ls /usr/bin/python*

예시:

$ ls /usr/bin/python*
/usr/bin/python3  /usr/bin/python3.8  /usr/bin/python3.10

여러 버전이 설치되어 있으면 기본으로 사용할 버전을 선택할 수 있습니다.

3.2 update-alternatives를 사용해 기본 Python 전환

update-alternatives를 사용해 기본 Python 버전을 전환할 수 있습니다.

먼저, 현재 설정을 확인하세요:

sudo update-alternatives --display python

python이 등록되어 있지 않으면 다음으로 추가하세요:

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1
sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.8 2

그 다음 기본 버전을 선택하세요:

sudo update-alternatives --config python

예시:

There are 2 choices for the alternative python (providing /usr/bin/python).

  Selection    Path                Priority   Status
------------------------------------------------------------
* 0            /usr/bin/python3.10  1         auto mode
  1            /usr/bin/python3.10  1         manual mode
  2            /usr/bin/python3.8   2         manual mode

Press <enter> to keep the current choice[*], or type selection number:

전환하려는 버전의 번호를 입력하세요.

3.3 심볼릭 링크 수동 변경

You can also manually change the symbolic link instead of using update-alternatives:

sudo ln -sf /usr/bin/python3.10 /usr/bin/python

This forces the python command to use python3.10 system-wide.

4. 프로젝트별 Python 버전 전환 방법

Ubuntu에서 Python을 사용할 때 프로젝트마다 다른 Python 버전을 사용하고 싶을 때가 있습니다.
예를 들어, 한 프로젝트는 Python 3.10이 필요하고, 다른 프로젝트는 Python 3.8이 필요할 수 있습니다.
이럴 때 가상 환경(venv)이나 pyenv를 활용하면 매우 편리합니다.

이 섹션에서는 가상 환경과 pyenv를 이용해 Python 버전을 손쉽게 전환하는 방법을 설명합니다.

4.1 venv 로 환경별 Python 버전 관리

Python은 venv(가상 환경) 를 표준 기능으로 제공합니다.
가상 환경을 사용하면 개별 디렉터리마다 서로 다른 Python 버전이나 라이브러리를 관리할 수 있습니다.

venv 로 가상 환경 만들기

가상 환경을 만들고 싶은 디렉터리로 이동한 뒤 다음을 실행합니다:

python3 -m venv myenv

이 명령은 myenv 라는 이름의 가상 환경을 생성합니다.

가상 환경 활성화

가상 환경을 활성화하려면 다음을 실행합니다:

source myenv/bin/activate

활성화되면 터미널 프롬프트가 다음과 같이 바뀝니다:

(myenv) user@ubuntu:~/project$

활성화된 상태에서는 해당 환경에 맞는 Python 버전이 사용됩니다.

가상 환경 내 Python 버전 확인

가상 환경 안에서 Python 버전을 확인하려면 다음을 실행합니다:

python --version

가상 환경 비활성화

가상 환경을 종료하려면 다음을 실행합니다:

deactivate

이 방법을 사용하면 프로젝트마다 독립적으로 Python 버전과 패키지를 관리할 수 있습니다.

4.2 pyenv 로 Python 버전 관리

venv 가 프로젝트별 Python을 관리한다면,
시스템 전체에서 자유롭게 Python 버전을 전환하고 싶을 때는 pyenv가 매우 편리합니다.

pyenv 설치

먼저 pyenv를 설치합니다. Ubuntu에 pyenv를 설치하려면 다음을 실행합니다:

curl https://pyenv.run | bash

그 다음 설정을 적용합니다:

exec $SHELL

pyenv 로 Python 버전 설치

pyenv를 사용해 Python 버전을 설치하려면:

pyenv install 3.10.6

사용 가능한 모든 버전을 확인하려면:

pyenv install --list

pyenv 로 Python 버전 전환

전역(시스템 전체) Python 버전을 변경하려면:

pyenv global 3.10.6

특정 디렉터리에서만 Python 버전을 변경하려면:

pyenv local 3.8.10

현재 pyenv Python 버전 확인

pyenv가 관리하고 있는 Python 버전을 확인하려면:

pyenv versions

이를 통해 프로젝트별로 다양한 Python 버전을 손쉽게 관리할 수 있습니다.

5. FAQ (문제 해결)

Ubuntu에서 Python 버전을 관리할 때 자주 묻는 질문과 해결 방법을 정리했습니다.

Q1: python 과 python3 의 차이는 무엇인가요?

Ubuntu에서는 python3가 표준이며, python은 Python 2를 가리킬 수 있습니다.
따라서 python3 --version을 사용하는 것이 권장됩니다.

Q2: python --version 이 예상치 못한 버전을 표시한다면?

update-alternatives 나 pyenv 로 기본 Python 버전을 변경할 수 있습니다.

  • update-alternatives 사용:
    sudo update-alternatives --config python
  • pyenv 사용:
    pyenv global 3.10.6

Q3: python3 --version 은 동작하지만 python 은 동작하지 않는 이유는?

python 명령이 설치되지 않았을 수 있습니다. 심볼릭 링크를 만들어 해결합니다:

sudo ln -sf /usr/bin/python3 /usr/bin/python

Q4: Ubuntu에서 오래된 Python 버전을 어떻게 제거하나요?

먼저 설치된 Python 패키지를 확인합니다:

apt list --installed | grep python

특정 Python 버전을 제거하려면:

sudo apt remove python3.6

Q5: 오래된 Python 버전을 제거하면 Ubuntu에 영향을 미치나요?

일부 Ubuntu 시스템 도구는 특정 Python 버전에 의존합니다. 영향을 확인하려면 다음을 실행합니다:

python3 --version

Before removing anything, always verify what is installed:

apt list --installed | grep python

6. 요약 및 추천 기사

이 가이드에서는 Ubuntu에서 Python 버전을 확인하고, 변경하고, 전환하는 방법을 다루었습니다.

  • Python 버전 확인 → python3 --version
  • 시스템 전체 버전 변경 → update-alternatives 또는 ln -sf
  • 프로젝트별 버전 관리 → venv 또는 pyenv

pyenv를 사용하면 Python 버전 관리가 특히 쉬워집니다.
여러 프로젝트에 걸쳐 서로 다른 Python 버전이 필요하거나 시스템 기본값을 변경하고 싶다면 pyenv를 사용해 보세요.

侍エンジニア塾