こんにちは！データサイエンスやAI開発の現場で、JupyterLabを毎日バリバリ使っていますか？
インタラクティブにコードを実行し、その場でグラフを描画できるJupyterLabは、私たちの研究やプロトタイピングのスピードを爆発的に高めてくれます。しかし、その一方で「JupyterLabを使っていると、コードのバージョン管理が怖くなる」という悩みを抱えたことはありませんか？
「昨日の夜、動いていたはずのコードが、どこを直したか分からなくて動かなくなった……」
「ファイル名に `final_v2_fix.ipynb` なんて名前をつけて、結局どれが本番か分からなくなった……」
そんな絶望を味わったことがあるあなたへ。今日は、JupyterLab上でGitとGitHubをシームレスに連携させ、二度とコードを失わないための「鉄壁の開発環境」の作り方を、優しく、そして徹底的に解説します。
これをマスターすれば、あなたの毎日のコーディングと実験管理は劇的に楽になりますよ。さあ、一緒にプロのバージョン管理の世界へ足を踏み入れましょう！
—
1. なぜJupyterLabにGit連携が必要なのか？（本質を理解する）
まず、私たちが直面している「JupyterLab特有の課題」について少しだけお話しさせてください。
一般的なPythonスクリプト（`.py`ファイル）であれば、VS CodeなどのエディタからGitで簡単に差分（diff）を確認できますよね。しかし、JupyterLabのノートブック（`.ipynb`ファイル）の中身を覗いたことはありますか？ あれは実はJSON形式の巨大なテキストファイルです。
ソースコードだけでなく、実行結果のテキスト、数式、さらにはプロットしたグラフの画像データ（Base64エンコードされた文字列）までが、1つのファイルにすべて詰め込まれています。そのため、通常のGitで差分を見ようとすると、次のような問題が発生します。
- コードを1行変えただけなのに、グラフデータやセルの実行回数（Execution Count）が変わっただけで、膨大な量の「意味のない差分」が表示される。
- 誰かと共同作業するときにコンフリクト（衝突）が起きて、JSONの構造が壊れ、ファイルが開かなくなる。
これを解決するのが、今回導入するJupyterLab Git拡張機能と、ノートブック専用の差分ツール`nbdime`です。これらを正しくセットアップすれば、JupyterLabの画面から直感的にGit操作ができ、人間にとって読みやすい綺麗な差分を確認できるようになります。
—
2. 環境構築の全体像
今回進めるステップは以下の3つです。どれも難しくありません。一つずつ確実に進めていきましょう。
1. JupyterLab Git拡張機能のインストール
2. GitHub認証（SSHキーの設定）の完了
3. 【超重要】ノートブックの差分を美しくする `nbdime` の導入
—
3. 実践！JupyterLab Git & nbdime 導入手順
それでは、ターミナル（MacならTerminal、WindowsならAnaconda Promptなど）を開いて、実際に環境を構築していきましょう。
ステップ1: 必要なパッケージのインストール
JupyterLabの拡張機能と、今回最大のキラーツールである `nbdime` を一括でインストールします。以下のコマンドを叩いてください。
JupyterLabの環境に、Git拡張機能とノートブック差分管理ツール(nbdime)をインストールします
pip install jupyterlab-git nbdime
インストールしたnbdimeをJupyterLabの拡張機能としてシステムに登録します
nbdime extensions –enable –sys-prefix
> 先輩からのアドバイス：
> `pip`でインストールした後は、JupyterLabを一度完全に再起動してください。拡張機能のビルドや読み込みに少し時間がかかることがありますが、焦らず待ちましょう。
—
ステップ2: GitHubとの認証設定（SSH接続の推奨）
JupyterLabのGit機能からGitHubへコードをプッシュ（送信）するためには、認証が必要です。パスワード認証は現在GitHubで廃止されているため、SSHキーを事前に登録しておくのが最も安全でスマートです。
もしお手元のPCにSSHキーがない場合は、以下の手順で作成し、GitHubの「Settings > SSH and GPG keys」に登録してください。
1. ターミナルでSSHキーを生成（メールアドレスはご自身のGitHubアカウントのものに変更）
ssh-keygen -t ed25519 -C “your_email@example.com”
2. 生成された公開鍵の内容をクリップボードにコピー（Macの場合の例）
cat ~/.ssh/id_ed25519.pub | pbcopy
コピーした公開鍵をGitHubのダッシュボードから登録すれば、認証の準備は完了です。
—
ステップ3: 動作確認とJupyterLabからのGit操作
すべての準備が整いました。JupyterLabを起動してみましょう。
JupyterLabを起動します
jupyter lab
ブラウザでJupyterLabが立ち上がったら、以下のポイントを確認してください。
1. 左サイドバーに「Gitアイコン（枝分かれしたマーク）」が出現していること
2. アイコンをクリックすると、現在のリポジトリの状態、ステージング、コミット履歴がGUIで美しく表示されること
実際にやってみよう（HelloWorld的Gitフロー）
1. 適当なノートブックを新規作成し、`print(“Hello, JupyterLab Git!”)` と書いて保存します。
2. 左側のGitタブを開くと、未追跡（Untracked）のファイルとしてノートブックが表示されます。
3. ファイル名の横にある `+` ボタン を押してステージングします。
4. コミットメッセージ（例: `feat: 初めてのノートブックを追加`）を入力し、「Commit」ボタン を押します。
これで、あなたのJupyterLab環境でのバージョン管理が成功しました！
—
4. 本日のハイライト：`nbdime` でノートブックの差分（diff）を制する
さて、ここからが本記事の真骨頂です。先ほどコミットしたノートブックのコードを少し書き換えてみてください。例えば、セルを追加して計算を実行してみます。
通常の状態だと、Gitの差分を見るときにJSONの呪文のようなコードが表示されて絶望しますが、`nbdime`を導入したあなたなら大丈夫です。
JupyterLabのGitタブから、変更したファイルの「Git Diff（差分）」を確認してみてください。
- 変更されたセルだけが、Pythonのコード形式（または綺麗なMarkdown形式）でハイライトされて表示されます。
- どこを追加し、どこを削除したのかが、一目で視覚的に分かります。
コマンドラインでスマートに差分を確認したいとき
もしターミナルやCLIから直接差分を確認したくなった場合も、`nbdime` が専用の美しいコマンドを用意してくれています。
直近の変更内容を、ターミナル上で美しく視覚的な差分として表示する
git-diff notebook.ipynb
このコマンドを実行すると、ターミナル上にまるでコードレビューツールのような綺麗な差分が表示されます。これもう、感動ものですよね。
—
まとめ：今日から「コードが消える恐怖」とは無縁の生活へ
お疲れ様でした！ ここまで設定を進めたあなたは、単にJupyterLabにプラグインを入れただけではありません。
- JupyterLabのGUIから直感的にコミット・プッシュができる環境
- チーム開発や未来の自分のために、ノートブックの差分を美しく管理できる `nbdime` の知見
これらを同時に手に入れました。もう「どのファイルが最新か分からない」「上書きして消してしまった」と頭を抱える夜は来ません。
バージョン管理という強力な盾を手に入れたことで、あなたはより大胆に、より攻めたデータ分析やAIモデルの実験に集中できるようになります。
毎日のコーディングが劇的に楽になるこの環境で、ぜひ最高のインサイトを生み出してください。あなたの開発ライフが、より豊かでクリエイティブなものになることを応援しています！