- 문제: 예제 코드는 정상 실행되는데도 편집기에서 빨간 밑줄이나 경고 메시지가 표시되는 문제
- 원인: 파이썬 관련 확장 프로그램의 Type Checking Mode가
basic또는strict로 설정되어 코드 타입을 더 엄격하게 점검함 - 해결법: VS Code 설정에서
Python › Analysis: Type Checking Mode를off로 변경 - 📋 자세한 설정 방법: docs/type-checking-mode.md 파일 참고
- 문제: 가상환경 생성 실패, 패키지 설치 오류, 인터프리터 인식 불가,
(.venv)표시 누락 등의 문제 - 원인: 기존 가상환경 꼬임, 터미널 프로필 설정 문제, 캐시 반영 지연 등으로 VS Code가 가상환경을 정상 인식하지 못함
- 해결법: 실행 중인 터미널을 종료한 뒤
Python: 환경 만들기로.venv를 다시 생성하고, VS Code를 새로고침하거나 다시 실행 - 📋 자세한 재설정 방법: docs/venv-setup.md 파일 참고
- 문제: 대화형 창에서
.venv커널이 표시되어도 Python 커널에 연결되지 않는 문제 - 원인: 관리자 권한으로 설치된 Python이 시스템 디렉토리에 있어, 일반 권한으로 실행되는 VS Code가 해당 경로에 정상 접근하지 못함
- 해결법: 기존 Python을 삭제한 뒤 일반 사용자 계정용으로 다시 설치하고, VS Code 재실행 후 가상환경을 다시 설정
- 📋 자세한 해결 방법: docs/python-install.md 파일 참고
- 문제: pandas, streamlit 등 최신 패키지 설치 중 빌드 오류가 발생하는 문제
- 원인: 윈도우 환경에서 일부 패키지 설치 시 Microsoft C++ 빌드 도구가 필요하거나, Python 버전 호환성 문제로 설치가 실패할 수 있음
- 해결법: 먼저
pip,setuptools,wheel을 업데이트하고, 필요 시 Microsoft C++ 빌드 도구를 설치하거나 PyPI에서 미리 빌드된.whl파일을 사용 - 📋 자세한 해결 방법: docs/ms-build-tools.md 파일 참고
일부 챕터의 코드가 외부 환경 변화로 인해 업데이트되었습니다. 원활한 실습을 위해 반드시 확인해 주세요!
- 문제: Inspector 실행 시 locator 음영처리가 안 되거나, 녹화된 코드가 JavaScript로 생성되는 문제
- 원인: 현재 버전에서는 Python 환경임에도 Node.js가 기본값으로 설정되는 버그
- 해결법: Inspector 창 우측 상단의 'Target' 메뉴 클릭 → Python > 'Pytest' 또는 'Library' 선택
- 📋 자세한 설정 방법: docs/inspector-target.md 파일 참고
- 성능 최적화 필수: step_2_3.py 실행 시 홈 디렉토리의 모든 폴더를 추출하므로 사전 작업이 필요합니다
- 권장 실습 순서:
- step_2_3.py 실행 →
step_2_3.json파일 생성 - JSON 파일을 열어 불필요한 폴더 목록 삭제 (⭐ 필수)
- step_2_4.py 실행하여 폴더 크기 측정
- step_2_3.py 실행 →
⚠️ 반드시 삭제해야 할 폴더: OneDrive, Google Drive, iCloud Drive 등 클라우드 폴더클라우드 폴더는 수천 개의 하위 폴더를 포함하여 실습 시간이 매우 길어집니다
- 패키지 업데이트: qrcode 패키지 최신 버전에서 에러 발생
- 에러 내용:
ValueError: Error correction level must be ERROR_CORRECT_H if an embedded image is provided - 해결책:
- 책 내용 그대로:
pip install "pillow==10.4.0" "qrcode==7.4.2" vobject(버전 고정) - 최신 버전 사용: step_3_1_new.py 파일 참고 또는 유튜브 강의 참고
- 책 내용 그대로:
- 환경 문제: EasyOCR 패키지가 일부 CPU에서 오류 없이 종료되는 현상 발생
- 해결책: PaddleOCR을 사용한 대체 코드 제공 (ch_05_paddleocr 폴더)
- 패키지 설치:
pip install -U paddlepaddle paddleocr pillow deepl streamlit ipywidgets setuptools - 주요 변경사항:
- EasyOCR → PaddleOCR로 변경
- 임시 파일 확장자
.tmp→.tmp.png로 변경
- 사이트 접근 문제: 네이버플러스 스토어 직접 접근 시 오류 발생
- 해결책: 네이버 메인 페이지 → 네이버플러스 스토어 버튼 클릭 방식으로 변경
⚠️ 변경된 파일: step_1_2.py, step_1_3.py
- 패키지 버전 관리: 원활한 실습을 위해 특정 버전 사용 필수
- Plotly 버전: 5.24.1 버전 권장 (
"plotly<6"설치) - Kaleido 버전: 0.2.1 버전 권장 (
"kaleido<1"설치) - 설치 명령어:
pip install -U playwright "kaleido<1" nbformat pandas "plotly<6" tqdm
- Streamlit 업데이트: 숫자 천 단위 구분 기호 표시 방식 변경
- 해결책: 데이터프레임 표시 시 명시적으로 포맷 지정 필요
- 주요 변경사항:
step_3_1.py:st.dataframe()→st.dataframe(df.style.format())로 변경step_3_2.py:column_config매개변수의format옵션에"localized"추가
- 네이버 지도 UI 변경: 웹사이트 UI 업데이트로 인한 요소 선택자(locator) 변경
- 수정된 파일: ch_12/step_1_3.py
- 주요 변경사항:
slow_mo=1000→slow_mo=2000: 브라우저 동작 속도 조절로 안정성 향상- 검색창 클릭:
get_by_label()→get_by_role("button", name="검색") - 키워드 입력:
get_by_label()→get_by_role("combobox", name="장소, 버스, 지하철, 주소 검색")
- 모델 업데이트: Gemma3 최신 버전 출시 (기존 Gemma2에서 업그레이드)
- 권장 사용법:
- 최신 권장:
ollama run gemma3:4b(빠른 속도, 적은 메모리) - 고성능 옵션:
ollama run gemma3:12b(높은 품질, 더 많은 메모리)
- 최신 권장:
- 코드 수정:
'gemma2:9b'→'gemma3:4b'또는'gemma3:12b'로 변경
- API 변경: Google에서 Gemini API 패키지명 변경
- 최신 버전: ch_14_genai 폴더 사용 권장
- 패키지 설치:
pip install -U google-cloud-texttospeech google-genai ipywidgets nltk streamlit ⚠️ 주요 변경사항:- 패키지명:
google-generativeai→google-genai - API 사용법 전면 변경 (자세한 내용은 ch_14_genai/README.md 참고)
- 시스템 프롬프트 일부 변경 (각 문장별 개행문자 추가) (자세한 내용은 ch_14_genai/README.md 참고)
- 패키지명:
- Python 버전 권장사항:
- 기본: Python 3.12.x 또는 3.13.x 버전
- Chapter 5 (EasyOCR): Python 3.12.x 필수
- Chapter 5 (PaddleOCR): Python 3.12.x 또는 3.13.x 모두 지원
- Python 3.12.x 설치 방법: ch_05/README.md 파일의 "🔽 파이썬 3.12.x 설치 가이드" 섹션 참고
- 패키지 설치: 각 챕터의
README.md파일에서 설치 명령어 확인 - 업데이트된 코드: 변경사항이 있는 챕터는 새로운 폴더의 코드 사용 필수
| 챕터 | 원본 폴더 | 업데이트 폴더 | 권장 사용 |
|---|---|---|---|
| Chapter 5 | ch_05 (EasyOCR) | ch_05_paddleocr (PaddleOCR) | 상황에 따라 선택 |
| Chapter 14 | ch_14 (구버전) | ch_14_genai (최신버전) | ch_14_genai ⭐ |
⭐ 표시된 옵션을 우선적으로 사용하시기 바랍니다.
기타 문의 사항이 있으실 경우 저자의 오픈 채팅에 문의해 주세요~!
