使用 VSCode 在 Linux 遠端編寫 Polyglot Notebook 跑 Python

看標題就知是篇冷門筆記。

如果你跟我一樣偏好 Polyglot Notebook 勝過 Jupyter Notebook，並需要在遠端 Linux (非 WSL) 跑 Python 筆記本，又想沿續 VSCode + Github Copilot AI 輔助開發的流暢，那你恰巧是本文為數不多的目標讀者，歡迎繼續讀下去。至於其他的朋友，我們下回見。(揮手下降)

我有個需求要在遠端 Linux (Ubuntu/Debian) 上跑 Python 程式，想用 Polyglot Notebook 觀察資料形式及摸索程式寫法。

之前學過使用 VSCode 遠端開發與測試 Linux 專案，知道 VSCode 能用 SSH 協定把 Linux 目錄當本地資料夾用，甚至能 Line By Line 偵錯，跟遠端主機做到無縫接軌。Ployglot Notebook 自然也可以這樣玩，但不到無腦安裝的地步，這裡簡單記錄安裝細節：

1. 若是第一次要在 Linux 跑 Polyglot 筆記，按 Ctrl-Shift-P 會發現找不到下圖的 「Polyglot Notebook: Create default notebook」選項：
   
   原因是 Linux 端需要先安裝相關程式。照慣例 Polyglot 套件有安裝鈕，點一下便會自動裝好：
   
2. Github Copilot 也一樣需要在 Linux 安裝 Remote Extension Host 才能跑，但也是點一下搞定：
   
3. 如此，我們便能建立 Polyglot 筆記，在 Code 區按 Ctrl-I 召喚 Copliot 助拳[1]、點上方的 Copilot 圖示[2]則可開啟右側 Chat 視窗[3]，切換到 AI 輔助高速 Coding 模式：
   
4. 選擇 Python Kernel 時，VSCode 會偵測 Linux 端有哪些 Python、pyenv 版本或 venv 虛擬環境，若沒有虛擬環境也可以當場用「Create Python Environment」建一個，操作體驗跟在本地開發無異：
   
   提醒如果要用現成虛擬環境，可能需要加裝 Jupyter Kernel 可能跟其他套件打架；建議為筆記新建虛擬環境，新建時會一併裝好 Jupyter Kernel 較省事。
5. 我遇到一個小狀況，在 Ubuntu 22.04 執行 Polyglot 筆記的 Python 程式碼出現「The kernel failed to start due to the missing module '_sqlite3'.」錯誤：
   
   根本原因超出我的知識範圍。最後參考網路討論：sudo apt install libsqlite3-dev、pyenv install 3.12.4 重裝 Python、砍掉 venv 環境重建一次排除問題。

This blog post outlines the steps to run Python programs on a remote Linux server using Polyglot Notebook in VSCode. It covers installing necessary extensions and setting up the environment for seamless coding, including handling potential issues with missing modules.