[에러 해결] 터미널 열 때마다 나오는 conda.exe 오류 1분 만에 완벽 해결하기 (PowerShell profile.ps1)

안녕하세요!

VS Code나 PowerShell 등 터미널 창을 새로 열 때마다 아래와 같이 기분 나쁜(?) 에러 메시지가 매번 출력되는 경우가 있습니다.

"conda.exe을(를) 찾을 수 없거나 실행할 수 없습니다..."

처음에는 프로젝트 수집기나 스크립트 엔진의 문제인 줄 알고 한참을 헤맸는데, 원인은 아주 엉뚱한 곳에 있었습니다. 바로 PowerShell의 프로필 설정 파일(profile.ps1) 문제였습니다.

과거에 아나콘다(Anaconda)를 설치했다가 삭제했거나 경로가 바뀌었는데, PowerShell이 시작될 때마다 없는 아나콘다 경로를 억지로 불러오려고('hook' 하려고) 하니 매번 에러를 뱉었던 것이죠.

지긋지긋한 이 오류를 1분 만에 깔끔하게 해결하는 2가지 방법을 정리해 공유합니다.

---

 

해결 방법

방법 1. 메모장으로 열어서 Conda 관련 코드만 삭제하기 (권장)

기존 프로필에 커스텀 단축어나 다른 유용한 설정이 남아있을 수 있으므로, 문제가 되는 아나콘다 설정만 지우는 것이 가장 안전합니다.

1. 시작 메뉴에서 PowerShell을 검색한 뒤, 마우스 우클릭하여 '관리자 권한으로 실행'을 선택합니다.

2. 아래 명령어를 입력해 메모장으로 프로필 파일을 엽니다.

PowerShell

 

notepad "C:\Users\Administrator\Documents\WindowsPowerShell\profile.ps1"

3. 메모장이 열리면 conda, Anaconda 관련 내용이 적힌 블록을 찾습니다. 보통 아래와 같이 생겼습니다.

PowerShell

 

# >>> conda initialize >>>
# !! Contents within this block are managed by 'conda init' !!
(& "C:\...\conda.exe" "shell.powershell" "hook") | Out-String | Invoke-Expression
# <<< conda initialize <<<

4. 이 부분을 과감하게 통째로 지운 후 저장(Ctrl + S)하고 메모장을 닫습니다.

---

방법 2. 프로필 파일 그냥 초기화하기 (가장 빠름)

"나는 프로필 파일에 다른 설정을 해둔 기억이 없다! 그냥 에러만 안 나게 싹 밀어버리고 싶다" 하시는 분들은 PowerShell에 아래 명령어 한 줄만 치시면 끝납니다. 파일 내용을 깨끗하게 비워줍니다.

PowerShell

 

Clear-Content "C:\Users\Administrator\Documents\WindowsPowerShell\profile.ps1"

---

결과 확인

설정을 마친 후, 열려 있던 터미널을 모두 닫고 새 터미널 창을 열어보세요.

매번 신경 쓰이게 만들던 conda.exe 오류 메시지가 마법처럼 사라지고 깔끔하게 프롬프트만 뜨는 것을 확인할 수 있습니다!

혹시 나중에 아나콘다를 다시 쓸 일이 생기더라도, 새 아나콘다 프롬프트에서 conda init powershell을 실행하면 알아서 경로를 새로 등록해 주니 걱정 없이 지우셔도 됩니다.

오늘도 스트레스 없는 쾌적한 개발 환경 만드세요!