Jupyter 노트북 열어보기 가이드

배경

나는 파이썬 코드를 작성할 때 Jupyter(주피터) 노트북을 종종 사용한다. 코드를 여러 부분들로 나눠서 작성하고, 실행하며 검증할 수 있어서 편리하다. 특히 좋은 점은 "주피터 노트북"을 저장하면 전체 과정이 "기록"으로 남는 것이다. 내 포스트들 중 일부는 그 자체로 주피터 노트북이다. 주피터 노트북이 생소한 독자분들을 위해서 claude.ai에게 요청하여 만든 사용 가이드를 올린다. 주피터 노트북이 있는 포스트들에 이 포스트를 링크할 계획이다.

 

 

Jupyter 노트북(.ipynb) 파일 열어보기 가이드

📋 ipynb 파일이란?

.ipynb 파일은 Jupyter 노트북 파일로, 파이썬 코드와 그 실행 결과, 텍스트 설명 등이 함께 저장된 대화형 문서입니다. 데이터 분석, 머신러닝, 연구 등에 널리 사용됩니다.

 

 

🚀 VSCode로 열어보기 (추천 방법)

1단계: VSCode 설치

• Visual Studio Code 공식 웹사이트에서 다운로드
• 운영체제에 맞는 버전을 선택하여 설치

 

2단계: Python 확장 프로그램 설치

1. VSCode 실행
2. 왼쪽 사이드바의 확장(Extensions) 아이콘 클릭 (네모 4개 모양)
3. 검색창에 "Python" 입력
4. Microsoft에서 제공하는 Python 확장 프로그램 설치

VSCode에서 Python 확장 프로그램을 설치합니다.

 

3단계: Jupyter 확장 프로그램 설치

1. 확장 프로그램 검색창에 "Jupyter" 입력
2. Jupyter 확장 프로그램 설치

VSCode에서 Jupyter 확장 프로그램을 설치합니다.

 

4단계: ipynb 파일 열기

1. VSCode에서 파일 > 열기 또는 Ctrl+O (Windows/Linux) / Cmd+O (Mac)
2. .ipynb 파일 선택
3. 파일이 노트북 형태로 열림

 

📱 노트북 인터페이스 이해하기

셀(Cell) 구조

주피터 노트북은 셀로 구성됩니다. 셀은 마크다운 셀과 코드 셀로 구분됩니다.

 

주요 기능

• ▶️ 실행 버튼: 각 셀의 왼쪽에 있는 재생 버튼으로 코드 실행 (단축키: Shift+Enter, Ctrl+Enter)
• 편집 모드: 셀을 클릭하면 내용 편집 가능
• 새 셀 추가: 셀 사이의 + Code 또는 + Markdown 버튼 클릭

 

 

🔧 필요한 준비사항

Python 설치 확인

VSCode 터미널에서 확인:

python --version
# 또는
python3 --version

 

필요한 패키지 설치

노트북에서 사용하는 라이브러리가 없다면 설치:

pip install pandas numpy matplotlib jupyter

 

 

🌐 대안 방법들

온라인에서 바로 보기

1. GitHub: GitHub에 업로드하면 자동으로 미리보기 제공
2. Google Colab:
   • colab.research.google.com 접속
   • 파일 업로드하여 실행 가능
3. nbviewer:
   • nbviewer.jupyter.org 접속
   • URL 또는 파일 업로드로 확인

 

로컬 Jupyter 설치 

VSCode가 아닌 jupyter를 설치하는 방법입니다. 

pip install jupyter
jupyter notebook

브라우저에서 localhost:8888 접속

 

 

⚡ 빠른 체크리스트

• VSCode 설치됨
• Python 확장 프로그램 설치됨
• Jupyter 확장 프로그램 설치됨
• Python이 시스템에 설치됨
• 필요한 패키지들이 설치됨

 

 

💡 팁

• 노트북은 순서대로 실행하는 것이 좋습니다
• 오류가 발생하면 필요한 패키지를 설치해보세요
• VSCode에서 Ctrl+Shift+P (Windows/Linux) / Cmd+Shift+P (Mac)로 명령 팔레트를 열어 Jupyter 관련 명령어를 찾을 수 있습니다

 

이제 .ipynb 파일을 VSCode에서 편리하게 열어보고 실행할 수 있습니다! 🎉