カーネル一覧が空、または使いたいPython環境だけ見つからない。
最初にJupyterLabを起動したPython環境を確かめ、目的の環境でipykernelを登録してください。JupyterLabの再インストールは、サービス環境とNotebookの実行環境を確認してからで十分です。
この手順は、JupyterLab 4.6でPythonカーネルが見つからない学生・研究者向けです。
仮想環境を切り替えた後にNotebookが動かなくなった方や、研究室のMac環境を管理する方も、順に確認できます。
JupyterLab 4.6でPythonカーネルが見つからないときは、層を分けて確認します
JupyterLabの画面を開く処理、カーネルの登録、Notebookで実際にコードを動かす処理は、同じものではありません。画面が開けても、プロジェクトで使うPythonがカーネルとして見つかるとは限りません。
まず、次の情報を記録します。環境を変えた後で比較できるよう、コマンドの結果や画面表示も残してください。
- [ ] JupyterLabのバージョンと起動方法
- [ ] 起動に使ったターミナル、仮想環境、ホスト
- [ ]
jupyter kernelspec listの実行結果 - [ ] Notebookで現在選択されているカーネル名
- [ ] 直前に変更したPython環境や依存パッケージ
JupyterLabの公式変更履歴では、2026年11月4日時点の安定版文書に4.6.5が示されています。タイトルの4.6は系列を指し、個々の環境で導入されている版は別途確認してください。参照：JupyterLabの公式変更履歴。
| 表示・動作 | 主に確認する場所 | 次の確認 |
|---|---|---|
| JupyterLabが起動しない | 起動コマンド、サービス環境 | 起動したPythonとJupyter Serverの設定 |
| 起動するがカーネル一覧が空 | カーネル仕様の検索結果 | jupyter kernelspec list |
| 一部の環境だけ一覧にない | 対象環境のipykernelと登録 | 対象Pythonで登録コマンドを実行 |
| Notebookは動くが結果が違う | 選択中のカーネルと依存関係 | sys.executable と必要パッケージ |
一覧が空の場合は、JupyterLabが参照するカーネルを調べます
JupyterLabを起動したターミナルで、次を実行します。
jupyter kernelspec list
このコマンドは、利用可能なカーネル仕様の名前と場所を確認する手がかりになります。Jupyterのカーネル仕様には、起動コマンドを表す argv、表示名の display_name、言語の language などが含まれます。表示名は任意に付けられるため、名前だけでは実際のPythonの場所を証明できません。詳細はカーネル仕様の公式説明を参照してください。
| 確認する結果 | 判断 | 対応 |
|---|---|---|
| リストにカーネルがない | この起動環境から見える登録がない可能性 | 起動方法と検索先を確認 |
| 別のプロジェクト名だけ表示 | 目的の環境が未登録の可能性 | 対象環境から登録 |
| 目的の名前はあるが起動しない | 登録先の実行ファイルが無効な可能性 | カーネル仕様内の起動先を確認 |
同じMac上でも、ターミナルの利用者アカウントや起動方法が異なると、登録したカーネルを見つけられないことがあります。Jupyter Serverの設定や起動環境を確認し、登録コマンドを実行したアカウントと照合してください。設定項目はJupyter Serverの公式設定資料で確認できます。
注意：ターミナルで
pythonが起動することと、JupyterLabにそのPythonがカーネルとして登録されていることは別です。Python単体の起動確認だけで修復済みと判断しないでください。
特定の仮想環境だけ見えない場合は、そこでipykernelを登録します
仮想環境にipykernelがインストール済みでも、その環境がJupyterLabのカーネル一覧に自動追加されるとは限りません。最初に、対象環境のPythonを有効にした状態でインストール先を確認します。
| 操作 | コマンド例 | 確認できること |
|---|---|---|
| ipykernelの有無を確認 | python -m pip show ipykernel |
実行中のPython環境にあるか |
| 対象環境から登録 | python -m ipykernel install --user --name project-env --display-name "Python (project-env)" |
カーネル仕様を登録したか |
| 登録結果を再確認 | jupyter kernelspec list |
起動側から登録先が見えるか |
project-env は環境に合わせて変更します。登録時は、目的の仮想環境を有効にしてコマンドを実行してください。登録の基本手順はIPythonのカーネルインストール資料に記載されています。Pythonの venv を使っている場合、環境を作成・管理する仕組みとカーネル登録は別の作業です。詳しくはPython公式のvenv説明を参照してください。
登録後も見つからない場合は、登録コマンドを実行したホストとJupyterLabを動かしているホストが同じか、利用者アカウントも同じかを見直します。カーネル名を変えるだけでは、Pythonの実行ファイルの場所は変わりません。
FAQ：登録後の確認と環境切り替え
仮想環境にipykernelを入れたのに、一覧に表示されない場合はどうしますか？
対象環境を有効にしてから登録コマンドを実行したか確認します。続いて、JupyterLabを起動した環境から jupyter kernelspec list を実行してください。別のアカウントやホストに登録していた場合は、起動側から見える環境で登録し直します。
Notebookが実際に使っているPythonはどこで確認できますか？
セルで import sys; print(sys.executable) を実行し、出力された実行ファイルの場所を記録します。カーネルメニューの表示名だけで判断せず、期待する仮想環境のパスか確認してください。さらに、研究に必要な主要パッケージを読み込めるか調べます。
新しいPython環境を作った後、以前のNotebookを使い続けられますか？
新環境に必要な依存パッケージを用意し、ipykernelを登録した後、Notebookで新しいカーネルを選びます。以前のNotebookファイルはそのままでも、セルを実行する環境は切り替わります。実行ファイルの場所と依存関係を確認してから分析を再開してください。
カーネルの表示名が目的の環境と同じなら、正しいPythonだと判断できますか？
いいえ。表示名は登録時に指定できるラベルであり、Pythonの実行先とは別です。セル内で実行ファイルの場所を確認し、必要な依存パッケージも検証してください。環境を移動・削除した後は、登録仕様が古い場所を指していないかも確認します。
Notebookが別のPythonを使う場合は、選択と依存関係を照合します
カーネルが起動しても、研究用の環境が正しく選ばれているとは限りません。Notebookのセルで次を実行し、実際にコードを動かしているPythonを調べます。
import sys
print(sys.executable)
出力されたパスがプロジェクトの仮想環境を指すか確認してください。次に、分析で必要なパッケージを読み込み、バージョンや入力データの読み込み結果を確認します。パッケージを全体環境に追加するのではなく、まずNotebookが選んでいる環境を見極めます。
JupyterLabのNotebookとカーネル選択については、公式のNotebook・カーネル案内に説明があります。起動操作や実行中のNotebookの確認は、JupyterLabの実行ガイドも参照してください。
登録後の起動失敗は、再登録より先に参照先を確認します
カーネルが一覧に出るのに起動しない、または繰り返し切断される場合は、カーネル仕様の起動先が現在も有効かを確認します。仮想環境を移動・削除した場合や、JupyterLabとは別のホストに環境を作った場合は、登録された実行ファイルの場所と実際の環境が一致しないことがあります。
問題を切り分けるときは、次の順で確認します。
- [ ] Notebookで選択中のカーネル名を確認する
- [ ]
jupyter kernelspec listで登録先を確認する - [ ] 対象の登録先が現在も存在するか確認する
- [ ] セルに短いPythonコードだけを入れて起動を試す
- [ ] 起動後に実行ファイルの場所と必要な依存関係を調べる
補足：この症状だけでJupyterLab 4.6固有の不具合とは判断できません。環境の移動、登録先、起動ホストを確認し、最小のコードで再現するかを切り分けてください。
| 選択肢 | 適している状況 | 確認する点 |
|---|---|---|
| 既存カーネルの参照先を修正 | 環境は残っており、登録だけ古い | 仕様に記録された起動先 |
| 対象環境から再登録 | 環境を作り直した、登録が見つからない | 有効化したPythonと登録先 |
| Notebookのカーネルを変更 | 複数環境が一覧にあり、別環境が選ばれていた | sys.executable と依存パッケージ |
| JupyterLabの再導入を検討 | 上記を確認してもサービス自体に問題が残る | 起動ログと設定、再現条件 |
修復後は、機密情報を含まない小さなコードで実行を確認し、プロジェクトに必要な依存パッケージと主要な分析処理も検証します。Notebook名、Pythonの実行ファイルの場所、カーネル名、必要なパッケージを記録すれば、同じ問題が起きたときに環境差を比較できます。
環境の分離や再現性を整える方法は、Macで研究用Python環境を準備するガイドも参考になります。研究室内でMacをどう補助的に使うか検討するときは、研究用途のMac活用例も確認できます。
macOSでの再検証が必要な場合は、作業場所を分けて考えます
まずは、JupyterLabの起動環境、カーネル登録、Notebookが使うPythonを照合してください。修復後も特定の分析処理をmacOS上で確認する必要があり、研究室に利用可能なMacがない場合は、遠隔のMac環境を補助として検討できます。
LinuxやWindows中心の研究室環境では、macOS固有の動作をそのまま確かめられません。HPCの利用条件によっては対話型の作業環境を使いにくく、個人でMacを購入すると管理や環境維持も必要になります。一方、遠隔Macは大量計算の常時運用や物理機器への接続を置き換えるものではありません。実データを扱う前に、所属機関の規則とデータ保護要件を確認してください。
短期間のmacOS検証が目的なら、利用可能な接続方法や適用範囲を日本向けMacレンタルの案内で確認できます。特定のJupyterLab設定や研究プロジェクトが必ず動くと決めつけず、まずは機密情報を含まない検証用Notebookで必要な手順を確かめてください。
よくある質問
JupyterLabは開くのにPythonカーネルが一覧に出ない場合、何から確認すればよいですか？
まず、JupyterLabを起動した環境で `jupyter kernelspec list` を実行し、利用可能なカーネルを確認します。Pythonをターミナルから起動できても、JupyterLabが参照するカーネルとして登録済みとは限りません。プロジェクト環境が一覧にない場合は、その環境でipykernelを登録してください。
仮想環境にipykernelを入れたのに、JupyterLabから見つからないのはなぜですか？
ipykernelを入れたPythonと、JupyterLabの起動に使ったPythonが別でも、カーネルは自動的に登録されません。対象の仮想環境を有効にしてから登録コマンドを実行し、JupyterLabと同じホスト、同じ利用者アカウントからカーネル一覧を確認します。
Notebookが選んでいるPython環境を、セルから確認できますか？
Notebookのセルで `import sys; print(sys.executable)` を実行すると、そのセルを実行しているPythonの実行ファイルの場所を確認できます。カーネル名の表示だけで環境を判断せず、表示されたパスとプロジェクトの依存パッケージを照合してください。
Python環境を変更した後、以前のNotebookで新しいカーネルを使うにはどうしますか？
新しい環境でipykernelを導入・登録した後、Notebook上部のカーネル選択メニューから登録したカーネルを選び直します。セル内で実行ファイルのパスと必要な依存パッケージを確認し、古い環境のパッケージが新環境にあると決めつけずに検証してください。
Python環境を整える専用リモートMacを、HireVMで
HireVMの専用Apple Silicon搭載Mac miniをレンタルして、用途に合わせたPython環境やカーネルを構成できます。