VS Code IDE

使用 VS Code Remote SSH 連接 Buda Agent 工作區，在本機 IDE 中編輯和偵錯程式碼。

VS Code IDE 適合在本機編輯 Agent 工作區裡的程式碼。設定完成後，你可以從 Buda 的 VSCode 開啟 入口直接連接工作區。

什麼時候使用 VS Code IDE

當你需要更完整的本機 IDE 體驗時，可以使用 VS Code IDE：

編輯多檔案專案
使用 VS Code 擴充套件
查看 Git 變更
偵錯前端或後端程式碼
讓 Agent 和人工開發在同一個工作區協作

如果只是預覽網頁效果，通常使用 WebPreview 更直接。

基本流程

在本機安裝 VS Code，並安裝 VS Code Remote SSH 擴充套件。
在本機安裝 websocat，並確認命令可以在終端機中直接執行。
在 Buda 彈窗裡貼上本機 SSH 公鑰內容。
複製彈窗裡的 SSH 設定，追加到本機 ~/.ssh/config。
點擊 開啟 VS Code，或在 VS Code Remote SSH 中選擇對應的 Host。

安裝 websocat

macOS 可以使用 Homebrew：

brew install websocat

Windows 和 Linux 可以使用 Cargo：

cargo install websocat

也可以從 websocat Releases 下載對應系統的二進位檔，並加入本機 PATH。

安裝後，在本機終端機執行：

websocat --version

如果終端機提示找不到命令，表示 websocat 還沒有加入 PATH。

找到 SSH 公鑰

常見公鑰檔案在：

~/.ssh/id_ed25519.pub
~/.ssh/id_rsa.pub

可以在本機終端機查看：

cat ~/.ssh/id_ed25519.pub

複製輸出的整行內容，貼到 Buda 彈窗的 新增 SSH 公鑰 區域。

如果還沒有 SSH key，可以建立一個：

ssh-keygen -t ed25519 -C "your-email@example.com"

建立後再查看 .pub 檔案內容。

設定 VS Code Remote SSH

Buda 彈窗會產生一段 Host buda-agent-... 開頭的 SSH 設定。請把它追加到本機：

~/.ssh/config

儲存後，在 VS Code 中執行：

Remote-SSH: Connect to Host

然後選擇 Buda 彈窗裡顯示的 Host。

Q&A

VS Code 提示找不到 websocat，怎麼辦？

在本機終端機執行 websocat --version。如果命令不存在，請重新安裝 websocat，或把 websocat 所在目錄加入 PATH。

連線時出現 Permission denied，怎麼辦？

請確認貼到 Buda 的是公鑰檔案內容，也就是 .pub 檔案內容，不是私鑰檔案。公鑰通常以 ssh-ed25519 或 ssh-rsa 開頭。

我有多個 SSH Key，需要手動指定 IdentityFile 嗎？

通常不需要。彈窗產生的 SSH 設定不會強制指定 IdentityFile，VS Code 會使用本機 SSH agent 或預設 key。

如果本機有多個 SSH key，而且 VS Code 選錯了 key，可以在彈窗產生的 Host 設定裡追加：

Host buda-agent-xxxx
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

請把 buda-agent-xxxx 換成彈窗裡產生的 Host，把 ~/.ssh/id_ed25519 換成你的私鑰路徑。

VS Code 一直連線中，怎麼辦？

請先確認：

Buda 彈窗裡的 SSH 設定已經儲存到本機 ~/.ssh/config
websocat --version 可以正常執行
已安裝 VS Code Remote SSH 擴充套件
Buda 工作區仍在執行

如果仍然失敗，可以回到 Buda 重新開啟 VS Code 連線彈窗，重新複製最新設定。