“파이썬 실행 환경 구축 과정에서 드러난 초보 사용자의 인지적 오해와 학습 전환 사례”

1. 하려던 것 (목표 설정)

  • 파이썬 기반 코드를 실행해
    → 자동화/프로그램 기능을 직접 사용해보려는 목적

  • “코드를 실행한다”는 개념을 이론이 아니라 실제 환경에서 체험하고자 함

  • 명령어, 라이브러리, 실행 방식에 대한 막연한 두려움을 줄이고
    혼자서 재현 가능한 수준까지 이해하는 것이 목표


2. 활용한 툴 및 환경

  • 운영체제: Windows

  • 언어/런타임: Python 3.14 (Windows Python Install Manager 사용)

  • 터미널: PowerShell

  • 패키지 관리 도구: pip

  • 라이브러리

    • requests : 외부 요청 처리

    • customtkinter : GUI 구성

    • openpyxl : 엑셀 파일 처리


3. 진행 세부 내용

① 파이썬 설치

  • 공식 설치 과정을 통해 Python 런타임 설치

  • python --version 명령으로 설치 확인

  • Python Install Manager(py)가 함께 설치됨을 확인

② 라이브러리 설치

  • pip install 명령을 통해 필요한 외부 라이브러리 설치

  • 초기에는 pip 인식 오류 발생 →
    python -m pip install … 방식으로 해결

  • 라이브러리 의존성 구조(하위 패키지 자동 설치)를 경험

③ 실행 오류 발생

  • python main.py 실행 시

    No such file or directory
    

    오류 반복 발생

  • 원인은 파이썬 문제나 라이브러리 문제가 아니라, 실행할 파일(main.py)이 존재하지 않았기 때문

④ 핵심 개념 이해

  • 파이썬 설치 = 실행 엔진 설치

  • .py 파일 = 사용자가 직접 만들어야 하는 실행 대상

  • 터미널의 “현재 위치”와 파일 위치가 다르면 실행 불가함을 인식

⑤ 최소 실행 파일 생성

  • 바탕화면에 main.py 파일 직접 생성

  • 내용:

    print("파이썬 설치 성공!")
    
  • PowerShell에서 해당 폴더 위치로 이동 후 실행 성공

⑥ 실행 시 콘솔이 바로 꺼지는 현상 경험

  • 더블 클릭 실행 시 창이 바로 닫히는 현상 발생

  • 이는 오류가 아니라 프로그램이 즉시 종료되었기 때문임을 이해

  • 터미널에서 실행하거나 input()으로 대기시키는 방식 학습


4. 시행착오 (중요 포인트)

  1. 파이썬을 설치하면 자동으로 실행 파일이 생길 거라는 오해

  2. main.py라는 파일이 “어디엔가 존재할 것”이라는 가정

  3. 터미널 위치 = 파이썬 설치 위치라고 생각함

  4. PowerShell과 명령 프롬프트(cmd)의 명령 차이로 인한 혼란

  5. .py 파일과 .txt 파일의 차이에 대한 초기 인식 부족

  6. “에러 메시지 = 실패”라고 해석한 인지적 자동 반응


5. 배운 점 (핵심 학습 정리)

① 파이썬 구조에 대한 이해

  • 파이썬은 앱이 아니라 실행 환경

  • 반드시 사용자가 작성한 .py 파일이 있어야 의미가 생김

② 실행의 본질

  • python 파일이름.py
    “이 위치에 있는 파일을 이 엔진으로 실행하라”는 명령

  • 파일 위치, 터미널 위치, 파일명 정확성이 실행의 핵심

③ 에러 메시지 읽는 관점 변화

  • 에러는 실패가 아니라 상태 정보

  • “No such file”은 코드 문제가 아니라 환경 문제라는 인식 전환

④ 최소 단위 실험의 중요성

  • print("…") 한 줄짜리 파일이

    • 설치

    • 경로

    • 실행

    • 출력
      전부를 검증하는 가장 강력한 테스트 도구임을 체감

⑤ 기술 학습에서의 메타 인식

  • 문제는 종종 “지식 부족”이 아니라
    개념을 잘못 가정한 상태에서 출발한 것

  • 작은 성공 경험이 이후 복잡한 자동화·GUI·엑셀 처리로 확장되는 기반이 됨


6. 사례 요약

본 사례는 파이썬 초입 사용자가 실행 환경과 파일 개념을 혼동하며 겪는 전형적인 시행착오를 다루며, 최소 실행 파일(.py)을 통한 단계적 검증 과정을 통해 파이썬 실행 구조, 터미널 사용 개념, 오류 해석 능력을 통합적으로 학습한 경험이다.

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요