jupyterLab

JupyterLab 기본 사용법

목적

JupyterLab은 브라우저 기반의 Python 개발 환경이다. 코드 작성과 실행, 결과 확인을 하나의 화면에서 할 수 있으며 데이터 분석, 머신러닝, 교육용 등 다양한 목적으로 널리 사용된다.

• jupyterlab — 메인 실행 환경으로, 클래식 Jupyter Notebook의 최신 버전이다. 파일 탐색기, 멀티 탭, 터미널 등을 갖춘 경량 IDE에 가까운 형태다.
• ipykernel — JupyterLab이 Python 코드를 실행할 때 사용하는 커널이다.
• ipywidgets — 노트북 안에서 슬라이더, 버튼 등 인터랙티브 위젯을 사용할 수 있게 해주는 확장이다.

---

설치

macOS / Windows 공통

세 패키지 모두 개발 도구 성격이므로 전역으로 설치한다.

uv pip install --system jupyterlab ipykernel ipywidgets

설치 확인:

jupyter lab --version

만약 'jupyter' is not recognized as an internal or external command, operable program or batch file. 오류 발생 시
 - PowerShell 재시작
 - 사용자 권한이 있는 폴더로 이동 (cd ~)
 - 다시 실행 (jupyter lab)

---

실행

jupyter lab

명령어를 실행하면 브라우저가 자동으로 열리며 JupyterLab이 시작된다. 자동으로 열리지 않으면 터미널에 출력된 URL을 브라우저에 직접 입력한다.

http://localhost:8888/lab

종료는 터미널에서 Ctrl + C를 누른다.

---

기본 동작 확인

1. 노트북 생성

JupyterLab 좌측 상단 + 버튼을 클릭하면 Launcher 탭이 열린다. Notebook 섹션 아래 Python 3 (ipykernel) 을 클릭하면 새 노트북이 생성된다.

2. 코드 실행

셀에 아래 코드를 입력하고 Shift + Enter로 실행한다.

print("Hello, JupyterLab!")

셀 아래에 Hello, JupyterLab!이 출력되면 정상이다.

3. ipywidgets 동작 확인

새 셀에 아래 코드를 입력하고 실행한다.

import ipywidgets as widgets
widgets.IntSlider(value=5, min=0, max=10)

슬라이더가 노트북 안에 표시되면 정상이다.

---

자주 쓰는 단축키

단축키 동작

Shift + Enter	셀 실행 후 다음 셀로 이동
Ctrl + Enter	셀 실행 (이동 없음)
A	위에 새 셀 추가
B	아래에 새 셀 추가
DD	셀 삭제
M	셀을 Markdown으로 변경
Y	셀을 Code로 변경

단축키는 셀을 선택한 상태(파란 테두리)에서 동작한다. 셀 안에서 편집 중(초록 테두리)일 때는 Esc를 눌러 선택 상태로 전환한다.

---

트러블슈팅

command not found: jupyter

설치 후 jupyter 명령어를 찾지 못하는 경우 아래 순서로 확인한다.

1. 설치 경로 확인

uv pip show --system jupyterlab

Location 항목에서 설치 경로를 확인한다. 실행 파일은 같은 경로의 bin 폴더에 있다.

ls /Users/yourname/.pyenv/versions/3.12.12/bin/ | grep jupyter

2. pyenv PATH 설정 확인

cat ~/.zshrc | grep pyenv

아래 세 줄이 모두 있어야 한다.

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

없거나 일부만 있으면 ~/.zshrc에 추가 후 다시 적용한다.

source ~/.zshrc

3. 다시 확인

jupyter lab --version

---

Code Completion 설정