在 VS Code 中管理 Jupyter 核心 (Kernels)

Visual Studio Code 的筆記本核心選取器可協助您為筆記本選取特定的核心。您可以點選筆記本右上角的選取核心 (Select Kernel),或透過指令選擇區 (Command Palette) 使用 Notebook: Select Notebook Kernel 指令來開啟核心選取器。

一旦開啟核心選取器,VS Code 會顯示最近使用 (MRU) 的核心。

MRU Kernel

注意:在舊版 VS Code (1.76 版本以前),VS Code 預設會顯示所有可用的核心。

若要查看其他核心,您可以點選選取另一個核心... (Select Another Kernel...)。所有現有的核心皆分類為核心來源選項,Jupyter 延伸模組開箱即支援這些來源。

Notebook Kernel Picker

預設情況下,VS Code 會建議您之前在該筆記本中使用過的核心,但您也可以選擇連線至任何其他 Jupyter 核心,如下所示。VS Code 也會記住您最後為筆記本選擇的核心,並在下次開啟筆記本時自動選取該核心。

Jupyter 核心

Jupyter 核心 (Jupyter Kernels) 分類列出了 VS Code 在其執行運算系統(您的桌面、GitHub Codespaces、遠端伺服器等)環境中偵測到的所有 Jupyter 核心。每個 Jupyter 核心都有一個 Jupyter 核心規格 (kernelspec),其中包含一個 JSON 檔案 (kernel.json),詳細說明了該核心的相關資訊,如名稱、描述以及啟動核心程序所需的 CLI 資訊。

Python 環境

Python 環境 (Python Environments) 分類列出了 VS Code 在其執行運算系統(您的桌面、Codespaces、遠端伺服器等)環境中偵測到的 Python 環境。它顯示了按類型(例如 conda, venv)分組的所有 Python 環境,無論是否已安裝 IPyKernel

注意:您不需要jupyter 安裝到您要使用的 Python 環境中。只需安裝 IPyKernel 套件即可啟動 Python 程序作為核心,並針對您的筆記本執行程式碼 (pip install ipykernel)。請參閱 Jupyter 延伸模組 wiki 以了解更多資訊。

現有的 Jupyter 伺服器

現有的 Jupyter 伺服器 (Existing Jupyter Server) 分類列出了先前連線過的遠端 Jupyter 伺服器。您也可以使用此選項來連線至正在遠端或本機執行的現有 Jupyter 伺服器。請找出您 Jupyter 伺服器的 URL(例如 http://<ip-address>:<port>/?token=<token>),並將其貼上至輸入執行中 Jupyter 伺服器的 URL (Enter the URL of the running Jupyter server) 選項中,以連線至該遠端伺服器並使用它來執行您的筆記本程式碼。

Enter server URL

當您啟動遠端伺服器時,請務必:

  1. 允許所有來源(例如 --NotebookApp.allow_origin='*'),以允許您的伺服器被外部存取。
  2. 設定筆記本接聽所有 IP (--NotebookApp.ip='0.0.0.0')。

連線後,所有現有的 Jupyter 工作階段都會出現在此清單中。

您可以透過下列方式從伺服器的核心規格建立新的工作階段:

  1. 執行 Notebook: Select Notebook Kernel 指令。
  2. 選擇 Select Another Kernel
  3. 選擇 Existing Jupyter Server
  4. 選擇您的伺服器。

Codespaces Jupyter 伺服器

連線至 Codespace (Connect to Codespace) 分類包含了一種特殊的 Jupyter 伺服器,您可以使用由 GitHub Codespaces 支援的遠端 Jupyter 伺服器,這是一種雲端資源,每月提供您 最高 60 小時的免費額度。若要使用 Codespaces Jupyter 伺服器,請:

  1. 安裝 GitHub Codespaces 延伸模組

    注意:如果您使用的是網頁版 VS Code (vscode.devgithub.dev),此延伸模組已預先安裝。同時請確保已安裝 Jupyter 延伸模組

  2. 前往指令選擇區 (⇧⌘P (Windows, Linux Ctrl+Shift+P)),選擇 Codespaces: Sign In 並按照步驟登入 Codespaces。

  3. 點選筆記本右上角的選取核心 (Select Kernel) 開啟核心選取器,然後選擇 Connect to Codespace

    提示:如果您沒有看到 Connect to Codespace 選項,請前往指令選擇區 (⇧⌘P (Windows, Linux Ctrl+Shift+P)),選擇 Developer: Reload Window 以重新載入視窗,然後再試一次。

您也可以在 GitHub Codespaces 頁面上管理您所有的 Codespaces 和 Codespaces Jupyter 伺服器,這並非必要操作。若要了解更多資訊,請閱讀 GitHub Codespaces 文件

新增核心選項

如果您電腦上沒有任何 Jupyter 核心或 Python 環境,VS Code 可以協助您進行設定:請前往指令選擇區 (⇧⌘P (Windows, Linux Ctrl+Shift+P)),選擇 Python: Create Environment,並依照提示操作。您也可以透過安裝其他延伸模組(例如 Azure Machine Learning)來增加選取核心的方法。

More Kernel Sources

問題或意見回饋

您可以透過在我們的儲存庫中建立 Issue 來提出 功能需求回報問題,我們的工程團隊會主動監控與管理這些內容。

© . This site is unofficial and not affiliated with Microsoft.