TipSnack | 생활정보·IT·AI 인사이트

 저도 처음에 PATH에서 막혔던 것처럼, FileNotFoundError 앞에서도 한참을 멍하니 있었던 기억이 있습니다. 분명 파일 탐색기에는 그 파일이 버젓이 존재하는데, VS Code에서 코드를 실행하면 계속 "그런 파일이나 디렉터리가 없다"는 오류만 뱉어내니 정말 당황스러웠습니다. 파일 이름을 몇 번이고 다시 확인해봐도 오타는 없었는데, 알고 보니 문제는 파일 이름이 아니라 코드가 실행되는 위치, 즉 작업 디렉터리가 제가 생각했던 곳과 전혀 다른 곳이었다는 사실이었습니다. 이번 글에서는 그때 겪었던 경험을 바탕으로, VS Code에서 Python을 사용할 때 자주 마주치는 FileNotFoundError의 원인과 해결 방법을 정리해보겠습니다. FileNotFoundError가 발생하는 근본 원인 작업 디렉터리라는 개념 이해하기 Python에서 open('sample.txt') 처럼 파일 경로를 상대 경로로 작성하면, 이 경로는 파일이 저장된 위치를 기준으로 하는 것이 아니라 코드가 실행되는 시점의 작업 디렉터리(Working Directory)를 기준으로 해석됩니다. 이 개념을 정확히 이해하지 못하면 파일이 분명히 존재하는데도 계속 찾지 못하는 상황에 빠지게 됩니다. 비유하자면 상대 경로는 마치 "우리 집에서 두 블록 떨어진 편의점"이라는 설명과 같습니다. 이 설명은 내가 지금 정확히 우리 집에 서 있을 때만 유효하며, 만약 다른 동네에서 출발한다면 전혀 엉뚱한 곳을 찾아 헤매게 됩니다. Python 코드도 마찬가지로, 지금 어느 위치를 기준으로 실행되고 있는지 모르면 상대 경로가 엉뚱한 곳을 가리키게 됩니다. FileNotFoundError가 발생하는 대표적인 상황 코드 실행 위치와 파일이 실제로 있는 위치가 다른 경우 파일 이름이나 확장자를 잘못 입력한 경우 파일 이름에 대소문자를 다르게 입력한 경우 폴더 경로 구분자를 운영체제와 맞지 않게 작성한 경우 파일이 실제로 아직 생성되...

 저도 처음에 PATH에서 막혔던 것처럼, Python 한글 문제에서도 비슷하게 한참을 헤맨 적이 있습니다. 분명 코드에는 멀쩡하게 한글을 입력했는데, 막상 실행하면 화면에 UnicodeDecodeError 가 뜨거나 알 수 없는 특수문자로 도배된 결과가 출력되어서 당황스러웠습니다. 파일을 새로 만들어도 보고 코드를 다시 써봐도 똑같길래 제 코드가 잘못된 줄 알았는데, 알고 보니 원인은 코드가 아니라 파일이 저장된 인코딩 방식과 실행 환경의 문자 설정이 서로 어긋나 있었던 것이었습니다. 이번 글에서는 그때 겪었던 경험을 바탕으로, VS Code에서 Python을 사용할 때 자주 마주치는 한글 깨짐 문제의 원인과 해결 방법을 정리해보겠습니다. 한글이 깨지는 근본 원인 인코딩이란 무엇인가 컴퓨터는 문자를 그대로 저장하는 것이 아니라 정해진 규칙에 따라 숫자로 변환해서 저장합니다. 이 변환 규칙을 인코딩이라고 부르는데, 대표적으로 영어권에서 주로 쓰이는 ASCII , 전 세계 문자를 대부분 표현할 수 있는 UTF-8 , 그리고 한글 윈도우에서 오랫동안 기본값으로 사용되어온 CP949(EUC-KR) 등이 있습니다. 비유하자면 인코딩은 마치 서로 다른 나라의 우편번호 체계와 같습니다. 같은 숫자라도 나라마다 가리키는 주소가 다르듯, 같은 바이트값이라도 어떤 인코딩 규칙으로 해석하느냐에 따라 전혀 다른 문자로 표시될 수 있습니다. 파일을 저장할 때 사용한 우편번호 체계와, 읽을 때 사용하는 우편번호 체계가 다르면 엉뚱한 주소, 즉 깨진 글자가 나타나는 것입니다. 한글 깨짐이 발생하는 대표적인 상황 파일을 읽거나 쓸 때 인코딩을 지정하지 않은 경우 콘솔(터미널) 자체의 문자 인코딩 설정이 다른 경우 CSV나 텍스트 파일을 다른 프로그램에서 받아왔을 때 인코딩이 다른 경우 소스 코드 파일 자체가 잘못된 인코딩으로 저장된 경우 운영체제 기본 인코딩이 UTF-8이 아닌 경우 파일 입출력에서 발생하는 한글 깨짐 해결하기 open() 함수에 인코딩...

 저도 처음에 PATH에서 막혔는데, Python을 분명 설치했는데도 VS Code에서 코드를 실행하면 "python은 내부 또는 외부 명령... 이 아닙니다"라는 메시지만 계속 나와서 몇 시간을 헤맸던 기억이 있습니다. 설치 프로그램을 여러 번 지웠다 다시 깔아봐도 마찬가지였는데, 알고 보니 문제는 Python 설치 자체가 아니라 VS Code가 Python을 찾아가는 경로 설정에 있었습니다. 이 글에서는 그때 겪었던 시행착오를 바탕으로, VS Code에서 Python이 실행되지 않을 때 확인해야 할 원인들을 순서대로 정리해보겠습니다. Python이 실행되지 않는 근본 원인 VS Code와 Python의 연결 구조 이해하기 VS Code는 그 자체로 Python을 실행하는 프로그램이 아닙니다. 컴퓨터에 별도로 설치된 Python 인터프리터를 찾아서 연결해주는 편집기 역할을 할 뿐입니다. 이 연결 구조를 이해하지 못하면 오류가 발생했을 때 엉뚱한 곳에서 원인을 찾게 됩니다. 비유하자면 VS Code는 마치 리모컨과 같고, Python은 그 리모컨이 조작하는 TV 본체와 같습니다. 리모컨 배터리가 아무리 좋아도 TV와 연결이 제대로 안 되어 있으면 화면이 켜지지 않는 것처럼, VS Code가 아무리 잘 설치되어 있어도 Python 인터프리터와의 연결이 어긋나 있으면 코드가 실행되지 않습니다. 자주 발생하는 오류 유형 터미널에서 python 명령어 자체를 인식하지 못하는 경우 VS Code가 엉뚱한 Python 인터프리터를 바라보고 있는 경우 확장 프로그램(Python Extension) 미설치로 인한 실행 오류 가상환경이 활성화되지 않아 발생하는 모듈 인식 오류 파일 경로에 한글이나 공백이 포함되어 발생하는 오류 PATH 환경변수 문제 해결하기 python 명령어를 인식하지 못하는 경우 VS Code 터미널에 python 이라고 입력했는데 명령어를 찾을 수 없다는 오류가 나온다면, Python 설치 과정에서 ...

  저도 처음에 PATH에서 막혔는데, Python을 새로 설치하고 필요한 패키지를 받으려고 pip install 을 입력했더니 "pip is not recognized as an internal or external command"라는 낯선 문구만 계속 나와서 당황했던 기억이 있습니다. 분명 설치 프로그램에서 "Next"만 눌렀을 뿐인데 왜 안 되는지 이해할 수 없어서 인터넷을 뒤지다가, 결국 문제는 Python 자체가 아니라 컴퓨터가 pip라는 명령어의 위치를 찾지 못하는 환경변수 문제라는 것을 알게 되었습니다. 이번 글에서는 그때 겪었던 경험을 바탕으로, VSCode에서 Python을 사용하다 마주치는 pip install 오류들을 유형별로 정리하고 해결하는 방법을 안내해보겠습니다. pip install 오류가 발생하는 이유 pip란 무엇인가 pip는 Python Package Index의 줄임말로, 다른 개발자들이 만들어놓은 라이브러리를 손쉽게 다운로드하고 설치할 수 있게 해주는 패키지 관리 도구입니다. Python을 설치하면 대부분 함께 설치되지만, 설치 과정이나 환경 설정에 따라 제대로 작동하지 않는 경우가 종종 발생합니다. 비유하자면 pip는 마치 동네 편의점 같은 존재입니다. 필요한 라이브러리(물건)를 코드 한 줄로 바로 주문하면 알아서 배달해주는데, 이 편의점으로 가는 길(환경변수)이 막혀 있거나 편의점 자체가 문을 닫아버리면 아무리 주문을 해도 물건을 받을 수 없는 상황이 벌어집니다. 자주 발생하는 오류 유형 pip 명령어 자체를 인식하지 못하는 경우 패키지 설치 권한이 부족한 경우 특정 패키지의 버전 호환성 문제 인터넷 연결이나 사내 네트워크 프록시 문제 여러 Python 버전이 충돌하는 경우 VSCode에서 pip 인식 오류 해결하기 pip 명령어를 찾지 못하는 경우 VSCode 터미널에 pip install 명령어를 입력했는데 "pip is not recognize...

저도 처음에 pip install 을 분명히 했는데 ModuleNotFoundError 가 계속 나와서 한참을 헤맸습니다. 알고 보니 가상환경이 활성화가 안 된 상태에서 설치했던 게 문제였습니다. 가상환경을 사용 중이라면 패키지를 설치하거나 코드를 실행하기 전에 반드시 가상환경이 활성화되었는지 확인해야 합니다. 아래의 절차를 통해 현재 환경을 점검해 보세요.   Python 을 배우다 보면 누구나 한 번은 마주치는 오류가 있습니다. 바로 ModuleNotFoundError: No module named 'XXX' 입니다. vscode 에서 코드를 실행하는 순간 이 빨간 글씨가 등장하면 당황스럽지만, 사실 이 오류는 원인이 명확하고 해결 방법도 분명합니다. 이 글에서는 ModuleNotFoundError 가 발생하는 다섯 가지 원인과 상황별 해결법을 단계별로 정리해 드리겠습니다. ModuleNotFoundError란 무엇인가 — 택배 주소를 찾을 수 없는 상황 오류의 정체 ModuleNotFoundError 는 Python 이 import 문으로 모듈을 불러오려 했지만 해당 모듈을 찾지 못했을 때 발생합니다. 아래처럼 생긴 오류 메시지가 바로 그것입니다. ModuleNotFoundError: No module named 'pandas' 택배에 비유하면 이렇습니다. import pandas 는 "판다스라는 이름의 택배를 가져와줘"라는 요청입니다. 그런데 창고(Python 환경)에 그 택배가 없으면 "해당 주소로 배달된 물건이 없습니다"라는 메시지가 뜨는 것입니다. 해결책은 단순합니다. 창고에 물건을 채워 넣거나(설치), 올바른 창고를 열거나(환경 확인), 주소를 정확히 쓰거나(경로 설정) 하면 됩니다. 오류가 발생하는 다섯 가지 상황 원인 1 — 라이브러리를 아예 설치하지 않은 경우 원인 2 — 가상환경이 활성화되지 않은 상태에서 설치한 경우 원인 3 — VS Code의 ...

 저도 처음에 PATH에서 막혔는데, 매일 반복되는 사내 시스템 클릭 작업을 자동화해보려고 pyautogui 를 설치했지만 VSCode에서 실행할 때마다 "No module named 'pyautogui'"라는 오류만 계속 나왔던 기억이 있습니다. 분명 터미널에서는 설치가 잘 됐다고 나왔는데, 알고 보니 VSCode가 바라보고 있던 Python 인터프리터 경로와 제가 패키지를 설치한 경로가 서로 달랐던 것이 원인이었습니다. 인터프리터를 올바르게 맞춰주고 나서야 마우스가 제 손을 대신해 화면을 클릭하고 키보드를 두드리는 신기한 광경을 볼 수 있었습니다. 이번 글에서는 그때의 시행착오를 바탕으로, VSCode 환경에서 Python pyautogui를 활용해 마우스와 키보드를 자동화하는 방법을 정리해보려 합니다. pyautogui란 무엇인가 마우스와 키보드를 코드로 제어하는 라이브러리 pyautogui 는 Python 코드로 마우스 움직임과 클릭, 키보드 입력을 프로그래밍적으로 제어할 수 있게 해주는 GUI 자동화 라이브러리입니다. 웹 브라우저나 애플리케이션 내부 요소를 직접 다루는 Selenium과 달리, pyautogui는 화면 좌표와 픽셀을 기준으로 동작하기 때문에 특정 프로그램에 국한되지 않고 컴퓨터 화면에서 벌어지는 거의 모든 작업을 자동화할 수 있습니다. 비유하자면 pyautogui는 마치 컴퓨터 앞에 보이지 않는 손 하나를 앉혀두는 것과 같습니다. 이 손은 사람이 시키는 대로 정확한 좌표를 클릭하고, 정해진 문장을 타이핑하며, 화면 속 특정 이미지를 찾아내기까지 하는데, 사람과 다른 점은 지치지 않고 똑같은 작업을 몇 번이고 정확하게 반복한다는 것입니다. pyautogui가 유용한 대표적인 상황 반복적인 클릭 작업이 많은 사내 시스템 업무 자동화 특정 시간마다 실행해야 하는 프로그램 작업 자동화 게임이나 소프트웨어 테스트 시 반복 입력 시뮬레이션 화면 캡처와 이미지 인식을 결합한 자동 작업 흐름 구성 매크로 프로그램을 대...

저도 처음에는 회사에서 매일 반복하던 번거로운 서버 배포 작업을 자동화해 보려고, 파이썬 스크립트 안에 깃( git ) 명령어를 넣어 실행하는 코드를 짰던 것이 시작이었습니다. 분명 내 터미널에 직접 입력할 때는 잘만 되던 명령어가, 파이썬 코드로 실행하니 자꾸 FileNotFoundError 만 뱉어내서 도대체 뭐가 문제인지 몇 시간이나 소스 코드 이 줄 저 줄을 뜯어고치며 밤새 삽질을 했습니다. 알고 보니 코드가 아니라 VS Code가 명령 프로그램의 위치를 찾지 못하는 'PATH 환경변수' 문제였죠. 실행 경로를 명시해 주자마자 스크립트가 배포 작업을 알아서 척척 단 5초 만에 끝내는 걸 보고 , 저는 이 파이썬 자동화의 강력함에 완전히 매료되었습니다. 이번 글에서는 그때의 시행착오를 바탕으로 subprocess 를 활용해 외부 명령어를 안전하게 제어하는 방법을 정리해 보겠습니다. Python 코드 안에서 터미널 명령어를 직접 실행하고 싶었던 적이 있으신가요? 예를 들어 git , ffmpeg , curl 같은 외부 프로그램을 Python 스크립트 안에서 자동으로 호출하고 그 결과를 받아와야 하는 경우가 생각보다 자주 발생합니다. 이럴 때 필요한 것이 바로 subprocess 모듈이며, 이를 활용하면 Python이 마치 터미널을 대신 조작하는 것처럼 외부 프로그램을 자유자재로 실행할 수 있습니다. 이번 글에서는 VSCode 환경에서 Python subprocess를 활용해 외부 명령어를 실행하고 결과를 처리하는 방법을 실전 예제와 함께 정리해보겠습니다. subprocess란 무엇인가 Python에서 외부 프로세스를 실행하는 표준 모듈 subprocess 는 Python 표준 라이브러리에 내장된 모듈로, Python 코드 안에서 운영체제의 명령어나 다른 프로그램을 새로운 프로세스로 실행할 수 있게 해줍니다. 쉽게 말해 여러분이 평소 터미널에 직접 타이핑하던 명령어를, Python 코드가 대신 입력해주고 그 결과까지 받아와주는 것이...

저도 처음에는 회사에서 스캔한 계약서 이미지 수십 장을 눈으로 보며 일일이 손으로 타이핑하고 있었습니다. A4 용지 30장이 넘어가는 글자들을 치다 보니 눈도 침침하고 손목이 부서질 것 같아 파이썬 OCR을 찾아보게 되었죠. 그런데 코드를 다 짜고 실행하니 계속 tesseract is not installed or it's not in your PATH 라는 에러만 뿜어대더라고요. 내가 뭘 잘못했나 싶어 프로그램만 5번 넘게 지웠다 깔며 3시간 동안 삽질 을 했습니다. 알고 보니 엔진은 잘 깔려 있었는데 컴퓨터가 길을 못 찾는 '환경변수' 문제였습니다. 코드에 딱 한 줄로 실행 파일 경로를 직접 지정해 주자마자, 단 1초 만에 이미지 속 글자들이 텍스트로 술술 뽑혀 나오는 신세계 를 보았습니다. 이 글을 읽는 분들은 저처럼 억울한 삽질을 하지 않으시길 바라는 마음으로, VS Code에서 파이썬 OCR을 완벽하게 세팅하고 활용하는 방법을 정리해 보겠습니다 스캔한 문서나 사진 속에 있는 글자를 일일이 손으로 타이핑해본 경험이 있으신가요? 명함 이미지에서 전화번호를 옮겨 적거나, 종이 영수증을 엑셀로 정리하는 작업은 생각보다 훨씬 번거롭고 시간이 오래 걸립니다. 이럴 때 필요한 기술이 바로 OCR(광학 문자 인식)이며, Python을 활용하면 이미지 속 텍스트를 자동으로 추출하는 프로그램을 손쉽게 만들 수 있습니다. 이번 글에서는 VSCode 환경에서 Python OCR 라이브러리를 설치하고 실제로 이미지에서 텍스트를 뽑아내는 방법까지 실전 예제와 함께 정리해보겠습니다. OCR이란 무엇인가 이미지 속 문자를 텍스트로 변환하는 기술 OCR은 Optical Character Recognition의 줄임말로, 이미지나 스캔 문서 안에 있는 문자를 인식해서 컴퓨터가 편집 가능한 텍스트 데이터로 변환해주는 기술입니다. 사람이 눈으로 글자를 읽고 이해하는 과정을 컴퓨터가 흉내 내는 것이라고 이해하면 쉽습니다. 비유하자면 OCR은 마치 외국어를...

저도 처음에는 회사에서 받은 수백 장의 상품 사진 크기를 줄이기 위해, 하나하나 포토샵으로 열어서 마우스 클릭을 반복하고 있었습니다. 정확히 100장쯤 처리했을 때 손가락 마디가 저려오며 '내가 지금 뭘 하고 있는 건가' 싶었던 기억 이 납니다. 반나절을 꼬박 의미 없는 클릭질에 쏟아붓고 나서야 검색을 해보니 파이썬으로 이 작업을 자동화할 수 있다는 걸 알게 되었고, 그렇게 만난 라이브러리가 바로 Pillow 였습니다. 처음에는 PIL 과 Pillow 라는 이름이 헷갈려 설치 과정에서 살짝 헤맸지만, 막상 익히고 나니 오전 내내 붙잡고 있던 수백 장의 이미지 리사이징 작업이 단 5초 만에 거짓말처럼 끝났습니다. 이번 글에서는 그때 제가 겪었던 시행착오를 바탕으로, VS Code 환경에서 Pillow를 설치하고 실무 이미지를 다루는 방법을 완벽하게 정리해 보겠습니다 이미지 파일의 크기를 줄이거나, 여러 장의 사진에 똑같은 워터마크를 넣거나, 특정 폴더에 있는 수백 장의 사진을 한 번에 리사이징해야 하는 상황을 겪어본 적이 있으신가요? 이런 반복적인 이미지 작업을 손으로 하나하나 처리하다 보면 시간이 순식간에 사라지는데, Python의 Pillow 라이브러리를 활용하면 이런 작업을 코드 몇 줄로 자동화할 수 있습니다. 이번 글에서는 VSCode 환경에서 Pillow를 설치하고 실제로 이미지를 다루는 방법까지 실전 예제와 함께 정리해보겠습니다. Pillow란 무엇인가 이미지 처리를 위한 Python 라이브러리 Pillow는 Python에서 이미지를 열고, 편집하고, 저장할 수 있게 해주는 대표적인 이미지 처리 라이브러리입니다. 원래는 PIL(Python Imaging Library)이라는 이름으로 시작했지만, 개발이 중단된 이후 커뮤니티가 이를 이어받아 Pillow라는 이름으로 발전시켜 지금까지 널리 사용되고 있습니다. 비유하자면 Pillow는 마치 포토샵의 기능 중 자주 쓰이는 도구들만 쏙쏙 뽑아서 코드로 자동 실행할 수 있게 만든 미니...