[樹莓派 5] 使用 VS Code 遠端開發 Python 程式

2025.03.08 / 樹莓派
VS Code 可以讓你透過網路直接在樹莓派上寫 Python,不用特地再弄一套螢幕、鍵盤和滑鼠,直接上機測試,效率高又方便。

我通常不會直接在樹莓派上寫程式,而是用 VS Code 來遠端開發。這樣做除了可以在熟悉的環境下做事,也能兼顧上機測試的目的。我們只要在 VS Code 安裝遠端開發的擴充功能,就可以輕易的透過 SSH 來實現遠端開發!

安裝 Remote Development

首先,請在你自己電腦上的 VS Code 安裝 Remote Development 擴充功能。

2025033088-AIhM3DQPnL.png

SSH 連線至樹莓派

接下來,請將樹莓派的電源接上,讓他開機。由於我們先前在 灌系統的時候 有設定要連線的無線網路,因此可以在路由器上找到樹莓派的 IP 位址,請把這串 IP 記下來。

2025033072-M1bixw1unX.png

回到 VS Code,從左側開啟遠端總管,並點擊 SSH 右邊的 +,輸入連線指令:

1ssh username@ip

請將 username 替換為你設定的樹莓派使用者名稱,ip 替換成剛才記錄的位址,最後按下 Enter。

2025033090-9WF0NumQ24.png

用鍵盤方向鍵選擇第一個選項,再按下 Enter,即可建立連線設定。

2025033091-NXM4nxUuYP.png

現在 SSH 的群組之下會出現我們剛才新增的連線設定,請按下它右邊的箭頭來啟動連線。

2025033092-qUWv9jSvu7.png

初次連線時需選擇目的地的作業系統,請選擇樹莓派使用的 Linux。

2025033093-XDqeJYa122.png

選擇繼續。

2025033094-aPjlG24W1d.png

最後再輸入灌系統時設定的使用者密碼。

2025033095-SJoJAMdpDc.png

建立專案資料夾

成功連線後,第一件事就是建立專案資料夾。請在右下的終端機區域輸入指令,建立 first-project 資料夾:

1mkdir first-project

建立成功後,請點擊左側的「開啟資料夾」。

2025033099-GfhXrXUI6C.png

下一步請選擇剛才建立的 first-project,VS Code 將會以這個資料夾為目的來重新連線。

2025033100-l5w9VJShoz.png

連線到資料夾後,可能會跳出信任的提示,請選擇「是,我信任作者」,接下來開始配置 Python 的開發環境。

2025033102-eUfhmU2cRI.png

建立 Python 虛擬開發環境

現在我們看到的 VS Code 是樹莓派上的環境,因此在開始寫程式之前,需要先把 Python 的擴充功能安裝起來。

2025033106-k4oEftnUfb.png

擴充功能安裝好後,就可以在專案內新增 main.py 並開啟,再點擊右下角的「選擇解譯器」來建立虛擬環境。

2025033107-WD61rtrr3K.png

選擇「建立虛擬環境」。

2025033108-59vNdOoNqL.png

選擇「Venv」。

2025033109-sPVeTGgUce.png

樹莓派預設有 Python 3.11,我們可以直接使用,任選一個即可。

2025033110-co5jS0nSLt.png

撰寫與執行 Python 程式

等待虛擬環境建好後,即可來撰寫 Python 程式。基於測試目的,我們可以印出一個字串:

1print("Hello world!")

寫好後點擊右上角的播放鍵來執行,終端機內就可以看到我們在樹莓派上用 Python 印出來的「Hello world!」字串。下一篇我們將來說明 如何在樹莓派上用 Python 控制 Arduino 腳位狀態

2025033113-vb3VhoEeNe.png

相關文章

Ted Liou

雲科碩士在讀中,專注於 Unity C#、TouchDesigner 技術。
只要願意以超連結標註本文,歡迎轉載或用於教材製作!