🚀 在 VS Code 中！

Web 上的 Jupyter Notebooks

Visual Studio Code 支援在桌面上使用 Jupyter Notebooks，並擴展到各種以瀏覽器為基礎的平台，例如 GitHub Codespaces 和 VS Code 網頁版。

使用這些以瀏覽器為基礎的平台，讓您無需在機器上安裝任何東西即可處理您的 notebook (以及更多！)。您可以在下方閱讀更多關於每個選項以及如何開始使用的資訊

Codespaces 上的 Jupyter Notebooks

在 VS Code 中開發 Jupyter notebook 可以完全透過以 Web 為基礎的介面完成，使用 GitHub Codespaces，這是一個雲端託管的開發環境，安全且可設定，並具有免費的運算資源 (關於 Codespaces 的更多資訊，請參閱 每月使用配額)。這表示您可以利用所有 VS Code 功能，包括 Jupyter notebook 支援，而無需在機器上安裝任何東西。若要快速開始使用

  1. 導覽至 https://github.com/codespaces。

  2. 在 [探索快速入門範本] 下，針對 [Jupyter Notebook] 選取 [使用此範本]。如果您沒有看到 [Jupyter Notebook] 範本，請選取 [查看全部] 並搜尋範本。

    Use Codespaces Jupyter Notebook Template

  3. 就這樣！系統將為您建立一個 codespace 以開始使用！

    提示：您可以將組態檔 (通常稱為程式碼即組態) 提交到您的存放庫來自訂您的專案，這會為您專案的所有使用者建立可重複的 codespace 組態。您也可以在 devcontainers/images 存放庫 上查看預先定義組態的範例，以用於您的專案並/或根據需要進行修改。

適用於 Web 的 VS Code 上的 Jupyter Notebooks

您也可以使用 VS Code 網頁版，方法是前往 https://vscode.dev 或 https://github.dev (在 GitHub 上檢視存放庫時，輸入 '.' 即可使用)。透過 VS Code 網頁版，您有兩個選項可以連線到 notebook 的下列核心類型

  1. 使用 VS Code Server 的遠端通道
  2. 連線到遠端 Jupyter 伺服器

使用 VS Code Server 的遠端通道

您可以安全地連線到遠端機器，而無需 SSH，方法是在您的遠端機器上安裝 VS Code Server，並透過 VS Code 網頁版存取它 (您也可以連線到 VS Code Desktop 上的伺服器)。若要執行此操作

  1. 在您的遠端機器上安裝 code CLI。

    注意：如果遠端機器上已安裝 VS Code Desktop，您可以跳過此步驟，因為 code CLI 已內建於 VS Code Desktop 中。

  2. 使用通道命令 code tunnel 建立安全通道 (如果您想要使用 VS Code 的每日發行版本，也可以執行 code-insiders tunnel)，並依照提示授予伺服器存取權。這會下載並啟動您遠端機器上的 VS Code Server，然後建立通往它的通道。

  3. 使用 CLI 的輸出 vscode.dev URL，該 URL 連結到此遠端機器，例如
    https://vscode.dev/tunnel/<machine_name>/<folder_name>
    以便在任何用戶端上存取此遠端機器。

  4. 開啟 notebook 檔案，並選取任何 Jupyter 核心或 Python 環境來執行您的程式碼。

連線到遠端 Jupyter 伺服器

您也可以透過貼上具有下列格式的 URL 來連線到任何遠端 Jupyter 伺服器
http://<ip-address>:<port>/?token=<token>.

若要執行此操作，請選取 [Jupyter: 指定 Jupyter 伺服器以進行連線] 命令，然後貼上您的遠端 Jupyter 伺服器的 URL。

Enter Jupyter server

若要使用舊版 VS Code 和 Jupyter 擴充功能輸入您的遠端 Jupyter 伺服器 URL

  1. 按一下狀態列上的 [Jupyter 伺服器:]。

    Jupyter Server Status bar item

  2. 選取 [現有]。

    Select Existing option from the Jupyter Server drop down

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

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

限制

由於 VS Code 網頁版完全在您的 Web 瀏覽器中執行，因此與桌面和 Codespaces 體驗相比，有一些限制。

  • 無法存取 VS Code 終端機 (雖然您可以從您的 notebook 儲存格執行 magic commands)
  • 有限的除錯
  • 部分 Python IntelliSense 支援
  • 不支援 isort 擴充功能

繼續在 Codespaces 上工作

與 VS Code Desktop 相同，您可以輕鬆地從 VS Code 網頁版 (https://vscode.dev 或 https://github.dev) 繼續在 Codespaces 上工作。當您選擇在新的 codespace 中 [繼續在...上工作] 時，您未提交的變更將會隨您移動。若要執行此操作

  1. 開啟命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 並選取 [繼續在...上工作...]。

  2. 選取 [建立新的 Codespace]。

    Continue working on

  3. 依照提示將您的工作變更儲存在雲端，並登入 Codespaces。

  4. 選取您的 codespace 的執行個體類型 (核心數、RAM 和儲存空間)。

您也可以手動提交變更，並透過 [遠端檔案總管] 建立 codespace

  1. 開啟命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 並選取 [Codespaces: 登入] 以登入 Codespaces。

  2. 從活動列導覽至 [遠端檔案總管] 檢視。

    Remote explorer tab

從 [遠端檔案總管] 檢視中，您可以連線到現有的 codespace 或建立新的 codespace。這將開啟一個新視窗，讓您可以繼續在 Codespaces 上處理您的專案。

問題或意見反應

您可以新增功能要求或回報問題，方法是在我們的存放庫中建立問題，我們的工程團隊正在積極監控和管理該存放庫。

1/9/2023