HOWTO · Python

Miniconda를 완전히 제거

Windows, macOS 또는 Linux에서 Miniconda를 안전하게 제거하고 필요할 때만 선택적 잔여물을 삭제합니다.

이 페이지의 내용

Miniconda를 안전하게 제거하려면 먼저 보관할 환경을 내보내고, 정확한 설치 접두사를 확인한 뒤 운영체제별 제거 프로그램을 사용합니다. 완전히 초기화하려는 경우에만 셸 설정과 conda 사용자 데이터를 지우세요. 이 선택 단계는 설정과 캐시된 패키지를 버릴 수 있습니다.

설치와 제거, 버전 확인처럼 환경을 다루는 절차는 파이썬 튜토리얼 하우투 모음의 환경 및 설정 가이드에 함께 정리되어 있습니다.

환경을 백업하고 설치 접두사 확인하기

Miniconda 설치를 제거하면 해당 설치 디렉터리 안의 환경과 패키지도 함께 삭제됩니다. 계속하기 전에 나중에 다시 만들 환경을 내보내세요. 예를 들어 conda env export --name myenv > myenv.yml을 실행하고 myenv.yml은 Miniconda 디렉터리 밖에 보관합니다. conda를 다시 설치한 뒤에는 conda env create --file myenv.yml로 환경을 재생성할 수 있습니다.

이름이 Miniconda처럼 보인다는 이유만으로 디렉터리를 삭제하지 마세요. macOS와 Linux에서는 먼저 conda에 기본 접두사를 확인합니다. 다음 사전 점검은 conda를 사용할 수 있으면 디렉터리를 출력하고, 사용할 수 없으면 삭제 전에 중단합니다.

if ! prefix="$(conda info --base 2>/dev/null)"; then
  printf '%s\n' 'conda is not on PATH; find the installation prefix before deleting anything.'
  exit 1
fi
printf 'Miniconda prefix: %s\n' "$prefix"

정상 설치라면 마지막 줄은 다음과 같은 형식입니다.

Miniconda prefix: /opt/miniconda3

사전 점검에서 conda가 PATH에 없다고 나오면 추측한 경로를 제거 명령에 넣지 마세요. 먼저 원래 설치 프로그램의 디렉터리를 찾거나 그 설치에 포함된 제거 프로그램을 사용합니다. 잘못된 접두사를 삭제하면 다른 conda 설치까지 지울 수 있으므로 이 경우에는 보수적으로 처리해야 합니다.

Windows에서 Miniconda 제거하기

Miniconda 설치와 함께 제공된 Windows 제거 프로그램을 사용하세요. 설정 > 앱 > 설치된 앱(이전 Windows에서는 앱 및 기능)을 열고 Miniconda를 선택한 다음 제거를 누릅니다. Anaconda Miniconda 제거 안내서에 현재 지원되는 절차가 설명되어 있습니다.

시작하기 전에 이 설치를 사용하는 명령 프롬프트, PowerShell, IDE 터미널 및 Python 프로세스를 닫습니다. 제거가 끝나면 새 터미널에서 where conda를 실행하세요. 이것이 유일한 conda 설치였다면 일치하는 실행 파일을 찾지 못했다는 메시지가 정상입니다. 여전히 경로가 나오면 확인하세요. 실수로 지우면 안 되는 별도의 Anaconda, Miniconda 또는 Miniforge 설치일 수 있습니다.

macOS 또는 Linux에서 Miniconda 제거하기

제공되는 설치 프로그램이라면 확인한 정확한 Miniconda 접두사에서 uninstall.sh 스크립트를 실행합니다. 일반적인 rm -rf 명령을 복사하지 말고 스크립트의 안내를 따르세요. 제거 프로그램은 사용자 수준 설정을 남길 수 있으므로, 공식 제거 안내서는 지원되는 제거와 선택적 정리를 구분합니다.

제거 프로그램을 사용할 수 없다면 수동 삭제는 첫 선택이 아니라 대안입니다. 접두사를 다시 확인하고, 제거하려는 Miniconda 설치가 맞는지 확인한 후 그 디렉터리 하나만 삭제하세요. conda 문서는 macOS의 수동 방법과 선택적 정리 단계를 설명합니다. rm -rf는 확인을 묻지 않고 되돌릴 수 없으므로 비어 있거나 검증되지 않은 경로, 또는 홈 디렉터리처럼 광범위한 경로에는 절대 실행하지 마세요.

제거 후 새 셸을 열어 command -v conda를 실행합니다. 출력이 없으면 현재 PATH에서 더 이상 명령을 찾지 못한다는 뜻입니다. 경로가 출력되면 다른 conda 설치가 남아 있거나 셸에 초기화 항목이 남아 있을 수 있습니다.

선택적 셸 및 사용자 데이터 잔여물 제거하기

핵심 제거 과정에서 conda 관련 파일을 모두 삭제할 필요는 없습니다. 사용자 계정의 conda를 초기화하려는 경우에만 다음 단계를 선택하세요.

  • conda를 아직 사용할 수 있을 때 설치를 삭제하기 전에 conda init --reverse --all로 셸 초기화를 되돌립니다. 또는 검토한 후 관련 셸 시작 파일에서 conda 초기화 블록만 지우세요.
  • 설정, 캐시된 패키지 또는 다른 사용자 데이터를 더 이상 쓰지 않을 때만 .condarc, .conda, .continuum 삭제를 고려합니다. 확신이 없으면 먼저 복사본을 보관하세요.
  • .bashrc, .zshrc, PowerShell 프로필에 오래된 Miniconda 경로가 있는지 확인합니다. 삭제한 설치를 가리키는 줄만 제거하고 새 터미널을 시작하세요.

anaconda-clean을 Miniconda의 기본 제거 도구로 사용하지 마세요. 이는 정리 유틸리티이며, 설치 자체는 지원되는 제거 프로그램 또는 신중히 확인한 수동 대안으로 처리합니다. 선택적 정리는 새로 재설치할 때 유용하지만 Miniconda 디렉터리만 되찾기 위해 꼭 필요하지는 않습니다.

결과 확인 및 필요 시 재설치하기

검증 결과에서는 제거한 접두사가 사라지고 새 터미널에서 해당 접두사의 conda 또는 이전 Python 실행 파일을 더 이상 찾지 않아야 합니다. Windows에서는 where conda, macOS 또는 Linux에서는 command -v conda를 사용합니다. 명령이 여전히 확인되면 PATH를 바꾸거나 다른 것을 삭제하기 전에 보고된 위치와 제거한 접두사를 비교하세요.

이전 설정 파일을 복원하지 않고도 나중에 Miniconda를 다시 설치할 수 있습니다. 필요할 때 저장한 YAML 파일에서 새 환경을 만드세요. 사용 중인 파일이나 권한 거부 때문에 제거가 실패하면 이 설치를 사용하는 프로그램을 닫고 적절한 계정 권한으로 지원되는 제거 프로그램을 다시 실행합니다. 확인하지 않은 경로를 강제로 삭제하지 마세요.