콘텐츠로 건너뛰기

Python 경로 추가 방법에 대해 어떻게 설명하나요?

[

Python 경로에 Python 추가하는 방법

여러분은 Python을 설치했지만 명령 프롬프트에서 python을 입력해도 동작하지 않거나 잘못된 버전의 Python이 실행된다는 메시지가 나올 수 있습니다.

이러한 문제를 해결하는 일반적인 방법은 Python을 PATH 환경 변수에 추가하는 것입니다. 이 튜토리얼에서는 Python을 PATH에 추가하는 방법을 알아보겠습니다. 또한 PATH가 무엇이며, 명령 프롬프트와 같은 프로그램이 Python 설치 위치를 찾을 수 있도록 PATH가 중요한 이유도 배우게 될 것입니다.

참고: 경로는 하드 드라이브의 파일 또는 폴더의 주소입니다. PATH 환경 변수는 운영 체제에서 실행 가능한 스크립트와 프로그램을 찾기 위해 유지 및 사용하는 디렉토리 경로 목록입니다.

PATH에 무언가를 추가하기 위해 필요한 단계는 주로 운영 체제(OS)에 따라 많이 달라집니다. 따라서 하나의 OS에 대한 절차에 관심이 있다면 해당 섹션으로 건너뛰도록 하세요.

이 절차는 Python뿐만 아니라 다른 프로그램도 PATH에 추가하는 데 사용할 수 있습니다.

Windows에서 Python을 PATH에 추가하는 방법

첫 번째 단계는 대상 Python 실행 파일이 있는 디렉토리를 찾는 것입니다. 디렉토리 경로를 PATH 환경 변수에 추가할 것입니다.

Python 실행 파일을 찾으려면 python.exe라는 파일을 찾아야 합니다. Python 실행 파일은 C:\Python\ 디렉토리나 AppData\ 폴더에 있을 수 있습니다. 예를 들어, 실행 파일이 AppData\에 있다면 경로는 보통 다음과 같을 것입니다:

Shell

C:\Users\<USER>\AppData\Local\Programs\Python

여기서 <USER> 부분은 현재 로그인한 사용자 이름으로 대체됩니다.

적절한 실행 파일을 찾는 데 어려움을 겪는다면 Windows 탐색기의 검색 기능을 사용할 수 있습니다. 그러나 내장 검색 기능은 너무 느리기 때문에 대안으로 Everything을 사용해 시스템 전체에서 파일을 슈퍼 빠르게 검색할 수 있습니다:

노란색으로 강조된 경로인 \WindowsApps\Python310은 설치의 루트 수준에 있는 실행 파일에 대한 이상적인 후보입니다. 빨간색으로 강조된 경로는 가상 환경의 일부인 경로뿐만 아니라 바로 가기나 내부 Windows 설치일 수 있으므로 적합하지 않습니다.

또한 Python 실행 파일이 다른 프로그램의 폴더에 설치되어 있는 경우도 있을 수 있습니다. 이는 많은 애플리케이션이 자체 Python 버전을 번들로 포함하기 때문입니다. 이러한 번들 Python 설치도 적합하지 않습니다.

Python 실행 파일을 찾은 후에는 시작 메뉴를 열고 시스템 환경 변수 편집 항목을 검색하여 시스템 속성 창을 엽니다. 고급 탭에서 환경 변수 버튼을 클릭합니다. 여기에서 편집할 수 있는 _사용자_와 시스템 변수를 볼 수 있습니다:

사용자 변수 섹션에서 Path 항목을 더블 클릭합니다. 목록이 표시되는 다른 창이 나타납니다. 새로 만들기 버튼을 클릭하고 Python 실행 파일의 경로를 붙여넣습니다. 이때 경로를 ;로 구분하여 여러 개의 경로를 추가할 수 있습니다. 경로를 추가한 후 창을 닫습니다.

이제 PATH에 Python이 추가되었습니다. 추가한 경로가 제대로 작동하는지 확인하기 위해 새 명령 프롬프트 창을 열고 python을 입력해 보세요. Python REPL이 시작되는지 확인할 수 있습니다.

Linux 및 macOS에서 Python을 PATH에 추가하는 방법

Linux와 macOS에서 Python을 PATH에 추가하는 방법도 간단합니다. 다음 명령을 터미널에서 사용하여 Python의 설치 경로를 찾을 수 있습니다:

Terminal window
which python3

이 명령을 실행하면 Python 실행 파일의 전체 경로가 출력됩니다. 출력된 경로를 복사합니다.

다음으로 터미널을 열고 홈 디렉토리에 있는 .bashrc 파일을 수정합니다. 아래 명령을 입력하여 .bashrc 파일을 엽니다:

Terminal window
nano ~/.bashrc

편집 모드에서 .bashrc 파일의 맨 아래로 스크롤하고 다음 줄을 추가합니다:

Terminal window
export PATH="/your/python/path:$PATH"

/your/python/path 부분을 복사한 Python 실행 파일 경로로 대체해야 합니다. 추가한 후에는 Ctrl + X를 눌러 편집을 종료하고 Y를 눌러 변경 사항을 저장합니다.

변경 사항을 적용하기 위해 터미널에서 다음 명령을 실행합니다:

Terminal window
source ~/.bashrc

이제 PATH에 Python이 추가되었습니다. 새 터미널 창을 열고 python3를 입력하여 Python REPL이 시작되는지 확인할 수 있습니다.

PATH가 무엇인지 이해하기

PATH는 운영 체제에서 파일이나 프로그램을 찾기 위해 사용하는 디렉토리 경로 목록입니다. PATH에는 다양한 디렉토리 경로가 포함될 수 있으며, 운영 체제는 PATH에 포함된 경로를 참조하여 실행 가능한 스크립트와 프로그램을 찾습니다.

예를 들어, 명령 프롬프트에서 python을 실행하려면 운영 체제는 PATH에 등록된 디렉토리에서 python.exe 파일을 찾아 실행합니다. PATH에 Python의 디렉토리 경로가 포함되어 있지 않으면 운영 체제는 해당 파일을 찾을 수 없다는 에러 메시지를 표시합니다.

따라서 Python을 PATH에 추가하면 운영 체제와 다른 프로그램들이 Python을 찾을 수 있으며, python이라는 명령을 사용하여 Python을 실행할 수 있게 됩니다.

PATH 내 순서의 중요성 이해하기

PATH에 포함된 경로의 순서는 매우 중요합니다. 운영 체제는 PATH의 첫 번째 경로부터 시작하여 해당 경로에서 실행 파일을 찾습니다. 만약 여러 경로에 동일한 이름의 실행 파일이 있다면 첫 번째 경로에 있는 실행 파일이 항상 우선적으로 실행됩니다.

예를 들어, C:\Python\C:\Program Files\Python\이라는 두 개의 경로가 PATH에 포함되어 있다고 가정해 보겠습니다. 이 경우 동일한 이름인 python.exe 파일이 두 경로에 모두 존재한다면 C:\Python\에 있는 파일이 우선적으로 실행될 것입니다.

따라서 Python을 PATH에 추가할 때는 먼저 실행하고자 하는 Python 버전의 경로를 PATH의 가장 앞쪽에 추가하는 것이 좋습니다. 이렇게 하면 항상 원하는 Python 버전이 실행되도록 할 수 있습니다.

Unix 기반 시스템에서 PATH 관리하기

Unix 기반 시스템에서는 PATH를 여러 곳에서 관리할 수 있습니다. 대부분의 경우 ~/.bashrc 파일이나 ~/.bash_profile 파일에 export PATH="..." 형식으로 PATH를 추가합니다. 이렇게 하면 로그인할 때마다 PATH가 설정됩니다.

Ubuntu, Debian 및 macOS에서는 경로를 /etc/environment 파일에 추가함으로써 시스템 전체에서 PATH를 설정할 수도 있습니다.

Linux 배포판이나 macOS에서 터미널을 열 때마다 PATH를 설정하려면 ~/.bashrc 또는 ~/.bash_profile 파일을 수정하면 됩니다. 이 파일들은 사용자별로 설정되는 파일로, 터미널 세션을 시작할 때마다 읽혀집니다.

결론

Python을 PATH에 추가하면 명령 프롬프트나 다른 프로그램에서 Python을 찾을 수 있게 됩니다. Windows, Linux 및 macOS에서 Python을 PATH에 추가하는 방법에 대해 알아보았습니다.

Windows에서는 시스템 속성에서 사용자 변수에 Python 실행 파일의 경로를 추가하면 되며, Linux와 macOS에서는 .bashrc 파일에 export PATH="..." 형식으로 경로를 추가하면 됩니다.

Python을 PATH에 추가하는 것은 Python 개발 환경을 설정하는 데 중요한 단계입니다. 이를 통해 Python 스크립트를 터미널에서 직접 실행하거나 다른 프로그램에서 Python을 사용할 수 있게 됩니다.