Skip to content

建立 2026-09-14 更新 2026-09-14

VS Code 與 WSL

把專案放在 Linux 檔案系統之後,還需要一個能「人在 Windows、工具在 Linux」的編輯器。Visual Studio Code 加上 WSL 擴充功能 就是這個角色。

官方逐步說明:Get started using VS Code with WSLRemote development in WSL。免費學習模組:Developing in WSL with Visual Studio Code

安裝位置很重要

  1. 在 Windows 安裝 VS Code,不要把 Windows 版安裝程式丟進 WSL 裡裝。
  2. 安裝時勾選 Add to PATH,這樣在 Linux 終端機才能打 code .
  3. 在 VS Code 擴充功能市集安裝 WSL(識別碼 ms-vscode-remote.remote-wsl)。若也要用 SSH 或 Dev Container,可改裝 Remote Development 套件。

連進 WSL

在 Linux 專案目錄:

cd ~/projects/demo
code .

第一次會在發行版裡安裝 VS Code Server(一小組與桌面版對應的伺服器)。視窗左下角應顯示 WSL: Ubuntu(名稱依發行版而異)。此時:

  • 整合式終端機是 Linux shell
  • 語言擴充功能(Python、ESLint 等)跑在 WSL 裡,用的是 Linux 的直譯器與套件
  • 你看到的仍是 Windows 上的 VS Code 介面

也可在 Windows 的 VS Code 按 Ctrl+Shift+P,選 WSL: Connect to WSLWSL: 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 段落開始看。