2025.02.06 TIL : 가상환경 설정 문제

TIL: VS Code에서 Jupyter Notebook에 가상환경 연결 문제 해결

🔍 오늘의 문제

오늘 VS Code에서 Jupyter Notebook을 실행하려고 했는데, 가상환경이 감지되지 않았다. where python 명령어를 실행해봤지만, Python 경로가 표시되지 않는 문제가 발생했다.

🛠️ 해결 과정

1. 환경 변수 설정

먼저, 환경 변수를 확인해보니 가상환경 경로가 설정되지 않은 것을 발견했다. 이를 해결하기 위해 다음 단계를 진행했다.

1. Advanced System Settings → Environment Variables로 이동
2. System Variables에서 Path 선택 후 Edit 클릭
3. Python 및 가상환경의 Scripts 경로를 추가
   • 예: C:\Users\사용자명\AppData\Local\Programs\Python\PythonXX\Scripts
   • 예: C:\Users\사용자명\.virtualenvs\가상환경명\Scripts
4. OK 버튼을 눌러 변경 사항 저장 후 VS Code를 재시작했다.

2. 가상환경 경로 추가 및 Jupyter 커널 등록

환경 변수를 설정한 후, 가상환경을 Jupyter Notebook에서 사용할 수 있도록 설정했다.

1. 터미널에서 가상환경 활성화

   # Windows (cmd)
   .venv\Scripts\activate
   
   # macOS/Linux
   source .venv/bin/activate
   

2. Jupyter 관련 패키지를 설치했다.

   pip install ipykernel jupyter
   

3. 가상환경을 Jupyter 커널에 등록했다.

   python -m ipykernel install --user --name <가상환경_이름> --display-name "Python (<가상환경_이름>)"
   

4. VS Code에서 Python: Select Interpreter 실행 후, 설정한 가상환경을 선택했다.

3. Jupyter Notebook 실행 및 커널 설정

위 단계를 완료한 후, VS Code에서 Jupyter Notebook을 실행하여 커널을 설정했다.

1. VS Code에서 Ctrl + Shift + P를 눌러 Jupyter: Create New Notebook 실행
2. 새 노트북을 만든 후, Kernel 선택에서 설정한 가상환경을 선택
3. 가상환경 내에서 코드 실행 가능 여부를 확인했다.

✅ 해결 결과

• VS Code에서 Jupyter Notebook이 정상적으로 가상환경을 인식했다.
• 이제 가상환경 내에서 Notebook을 실행할 수 있다.

🔖 추가 참고 사항

• jupyter notebook이 설치되지 않았다면, pip install notebook을 실행하면 된다.
• pip list를 실행하여 ipykernel, jupyter 패키지가 설치되었는지 확인할 수 있다.
• Jupyter Notebook이 여전히 가상환경을 인식하지 못하면, VS Code를 재시작한 후 다시 시도하면 해결된다.