過去バージョン

この記事の要点
Jupyter Notebook が起動しない主な原因: インストール不完全 / ポート競合 / 認証トークン問題 / ブラウザ非起動 対処 ①: pip install --upgrade jupyter で再インストール 対処 ②: jupyter notebook --port 8889 で別ポート 対処 ③: jupyter notebook list で実行中インスタンスとトークン確認 JupyterLab に乗り換えるのも有効: pip install jupyterlab; jupyter lab

 

パターン別の対処

パターン 1: コマンドが見つからない

$ jupyter notebook
bash: jupyter: command not found

原因: Jupyter が未インストール or PATH が通っていない

# 確認
$ pip show jupyter
# 未インストールなら出力なし

# インストール
$ pip install --upgrade jupyter

# Anaconda 環境なら
$ conda install jupyter

# パス確認
$ which jupyter  # Linux/Mac
$ where jupyter  # Windows

パターン 2: ポートが使用中

$ jupyter notebook
[I] 8888 already in use, trying another port
[I] Jupyter Notebook is running at: http://localhost:8889/

別のプロセスが 8888 を使用中。対処:

# 別ポートで起動
$ jupyter notebook --port 8889

# 占有プロセスを確認
$ lsof -i :8888    # Linux/Mac
$ netstat -ano | findstr :8888  # Windows

# プロセスを終了
$ kill -9 <PID>

パターン 3: ブラウザが自動で開かない

# ターミナルに表示される URL をコピーしてブラウザに貼り付け
[I] http://localhost:8888/?token=abc123def456...

# またはブラウザ起動を抑止して URL だけ確認
$ jupyter notebook --no-browser

# デフォルトブラウザを指定
$ jupyter notebook --browser=chrome

パターン 4: 認証トークンエラー

古い URL を使ったり、別のターミナルで起動した Jupyter にアクセスしようとした場合:

# 現在実行中の Jupyter インスタンスとトークンを確認
$ jupyter notebook list
Currently running servers:
http://localhost:8888/?token=abc123def456... :: /home/user

# トークンを無効化して起動（開発用のみ）
$ jupyter notebook --NotebookApp.token='' --NotebookApp.password=''

# パスワード方式に切替
$ jupyter notebook password
Enter password: ****
Verify password: ****

パターン 5: カーネルエラー（Dead kernel）

起動はするがコード実行時に「カーネルが死にました」と出る:

# Python カーネルを再インストール
$ python -m ipykernel install --user

# 利用可能カーネル確認
$ jupyter kernelspec list

# カーネル削除＋再追加
$ jupyter kernelspec uninstall python3
$ python -m ipykernel install --user --name=python3

パターン 6: 依存関係エラー

# よくあるエラー
ImportError: cannot import name 'soft_unicode' from 'markupsafe'

# 対処: markupsafe をダウングレード
$ pip install markupsafe==2.0.1

# またはまとめて更新
$ pip install --upgrade jupyter notebook ipython markupsafe

パターン 7: Windows で文字化け・パスエラー

# 日本語ユーザー名のパスでエラーが出ることがある
# C:\Users\田中\... → 英数字パスに変更
$ set JUPYTER_DATA_DIR=C:\jupyter_data
$ jupyter notebook

JupyterLab への移行（推奨）

Jupyter Notebook (Classic) より新しい JupyterLab がアクティブに開発されています。

$ pip install jupyterlab
$ jupyter lab

# ブラウザで http://localhost:8888/lab が開く

メリット:

• タブ式 UI で複数ノートを並列表示
• ターミナル・ファイルブラウザ統合
• 拡張機能エコシステム
• Notebook (Classic) も併用可能

Anaconda 環境での Jupyter

# Anaconda Navigator で起動
# または
$ conda activate myenv
$ jupyter notebook

# 仮想環境のカーネルを追加
$ conda activate myenv
$ pip install ipykernel
$ python -m ipykernel install --user --name=myenv --display-name="Python (myenv)"

SSH 越しのリモート Jupyter

サーバ側で起動した Jupyter にローカルブラウザからアクセス:

# サーバ側（リモート）
$ jupyter notebook --no-browser --port 8888

# ローカル側（SSH ポートフォワーディング）
$ ssh -L 8888:localhost:8888 user@remote-server

# ローカルブラウザで http://localhost:8888 を開く

関連記事

• インストール方法(Windows)