WSL上のJupyter NotebookをWindowsのVSCodeから利用する完全ガイド

WSL上のJupyter NotebookをWindowsのVS Code (Cursor) から利用する完全ガイド：2025/01/02 10:40

はじめに

WSLとWindowsの共存環境で開発を行う際、以下の方針が効果的です：

• Python関連の環境はWSL側に集約
• エディター（Microsoft Visual Studio Code、以下、VS Code）はWindows側を使用
• Jupyter NotebookをWSLで動かしVS Codeから操作

前提条件

• Microsoft Windows 11
• WSL2 (Ubuntu 24.04)
• Microsoft VS Code (Cursor)
• Python 3.x（WSL側）

環境構築手順

1. WSLの基本設定

# WSLのアップデート
sudo apt update
sudo apt upgrade -y

# 必要なパッケージのインストール
sudo apt install -y python3 python3-pip python3-venv

2. Python仮想環境の作成

# ホームディレクトリーに仮想環境を作成
python3 -m venv ~/jupyter_env

# 仮想環境を有効化
source ~/jupyter_env/bin/activate

# pipのアップグレード
pip install --upgrade pip

# Jupyter関連パッケージのインストール
pip install jupyter notebook ipykernel

3. VS Code (Cursor) の設定

1. 必須拡張機能のインストール

   • Remote - WSL
   • Python
   • Jupyter

2. WSL接続の確立

   • リモートエクスプローラーを開く（サイドバーのアイコン）
   • WSLターゲットを展開
   • Ubuntu-24.04を選択
   • 「新しいウィンドウで接続する」をクリック
   • 左下がWSL: Ubuntu-24.04と表示されることを確認

3. settings.jsonの設定

{
    "python.defaultInterpreterPath": "~/jupyter_env/bin/python",
    "python.terminal.activateEnvironment": true,
    "jupyter.notebookFileRoot": "${workspaceFolder}"
}

4. Jupyter Notebookの作成と実行

1. 新規ノートブックの作成

   • エクスプローラーで任意のフォルダーを開く
   • 新規ファイル作成で.ipynb拡張子を指定
   • または、コマンドパレット（Ctrl+Shift+P）からJupyter: Create New Blank Notebookを選択

2. インターフェイスの確認

   • + コードと+ マークダウンボタンが表示される
   • カーネルがjupyter_envになっていることを確認

使用方法

Jupyter Notebookの起動

1. WSL側での起動:

# 仮想環境の有効化
source ~/jupyter_env/bin/activate

# Jupyterの起動
jupyter notebook

2.VS Codeでの操作:

• Ctrl + Shift + Pでコマンドパレットを開く
• Python: Create New Blank Jupyter Notebookを選択

よく使う操作例

# マークダウンセルの例
"""
# タイトル
## サブタイトル
- リスト1
- リスト2
"""

# コードセルの例
import pandas as pd
import numpy as np

# ヒアドキュメントの例
query = """
SELECT *
FROM table
WHERE column = 'value'
"""

トラブルシューティング

1. カーネルが見つからない場合

python -m ipykernel install --user --name=jupyter_env

1. WSL接続エラーの場合

wsl --shutdown

注意点

• WSL上のファイルシステムへのアクセスは\\wsl$経由より、VS CodeのWSL拡張経由の方が安定します
• 大規模なデータ処理を行う場合は、WSLのリソース制限を確認してください
• Jupyter Notebookのセッション情報は~/.jupyterに保存されます

補足情報

WSLのファイルシステムへのアクセス

• Windowsエクスプローラーから: \\wsl$\Ubuntu-24.04\home\ユーザー名
• WSL側から: explorer.exe .で現在のディレクトリーをエクスプローラーで開く

推奨される使用方法

• プロジェクトのファイルはWSL側に置く
• エディター操作はWindows側のVS Code (Cursor) から行う
• パッケージのインストールはWSL側の仮想環境で行う

参考情報

• WSLのメモリー使用量の確認:

free -h

• プロセス確認:

ps aux | grep jupyter

まとめ

この構成により：

• Windows環境の整理整頓が容易
• Python環境の管理が簡単
• WSL-Windows間のシームレスな連携が実現
• 開発環境の再現性が高まる
• ドキュメント化が容易になる

タグ: #Python #WSL #VSCode #Jupyter #Cursor #開発環境