8. 문제 해결 가이드

출처: 원본 PDF 04차시_실습환경구축.pdf 11쪽 · 쪽 그림 11쪽

설정 중에 문제가 발생할 수 있습니다. 여기 있는 해결책을 시도해보세요.

문제 1: "python: command not found"
증상 — Terminal에서 python 명령어가 먹히지 않음
해결책
• Windows: Python 재설치 시 "Add Python to PATH" 반드시 체크
• Mac: python3 명령어 사용 (python 대신)
• Linux: sudo apt install python3-full 실행
문제 2: 가상환경 활성화 안 됨
증상 — Terminal에 (venv)가 나타나지 않음
해결책
• Windows: cd로 RAG_Project 폴더로 이동 후 venv\Scripts\activate 실행
• Mac/Linux: source venv/bin/activate 실행
• 가상환경이 진짜 생성되었는지 ls 또는 dir로 확인
문제 3: "pip: command not found"
증상 — pip 명령어가 먹히지 않음
해결책 — python -m pip install 로 시작해보세요
예: python -m pip install langchain
문제 4: 라이브러리 설치 중 에러
증상 — 라이브러리 설치 중 오류 메시지 출력
해결책
​1. pip를 최신 버전으로 업그레이드: python -m pip install --upgrade pip
​2. 그 후 라이브러리 다시 설치
문제 5: VSCode에서 Python 인터프리터 선택 안 됨 증상 — VSCode가 Python을 찾지 못함
해결책
​1. Ctrl+Shift+P (Mac은 Cmd+Shift+P)
​2. "Python: Select Interpreter" 검색
​3. "./venv/bin/python" 또는 "./venv/Scripts/python" 선택