VS Code 與 WSL
把專案放在 Linux 檔案系統之後,還需要一個能「人在 Windows、工具在 Linux」的編輯器。Visual Studio Code 加上 WSL 擴充功能 就是這個角色。
官方逐步說明:Get started using VS Code with WSL、Remote development in WSL。免費學習模組:Developing in WSL with Visual Studio Code。
安裝位置很重要
- 在 Windows 安裝 VS Code,不要把 Windows 版安裝程式丟進 WSL 裡裝。
- 安裝時勾選 Add to PATH,這樣在 Linux 終端機才能打
code .。 - 在 VS Code 擴充功能市集安裝 WSL(識別碼
ms-vscode-remote.remote-wsl)。若也要用 SSH 或 Dev Container,可改裝 Remote Development 套件。
連進 WSL
在 Linux 專案目錄:
第一次會在發行版裡安裝 VS Code Server(一小組與桌面版對應的伺服器)。視窗左下角應顯示 WSL: Ubuntu(名稱依發行版而異)。此時:
- 整合式終端機是 Linux shell
- 語言擴充功能(Python、ESLint 等)跑在 WSL 裡,用的是 Linux 的直譯器與套件
- 你看到的仍是 Windows 上的 VS Code 介面
也可在 Windows 的 VS Code 按 Ctrl+Shift+P,選 WSL: Connect to WSL 或 WSL: Reopen Folder in WSL。
擴充功能裝兩份?
桌面端與 WSL 端的擴充功能是分開的。主題、keymap 裝在 Windows 即可;語言伺服器、除錯器、linter 要裝在 WSL: 發行版那一區。擴充功能檢視會標示「在 WSL 中安裝」。只裝在 Windows 時,補全與除錯會對不到 Linux 裡的 Python/Node。
部分精簡發行版缺少 VS Code Server 依賴的函式庫,依官方提示用套件管理員補即可。
官方示範
Tabs vs Spaces 這集用約半小時講 VS Code 的遠端開發:SSH、虛擬機器與 WSL 是同一套「本機 UI + 遠端 Server」模型。可從 WSL 段落開始看。