如果你想在 Windows 上直接用 VS Code 管理並建置 Docker 映像，流程其實不長。核心就是三步：先把環境準備好，再建立 Dockerfile，最後執行建置。

01 前置準備

先確認兩個基礎條件：

1. 安裝並啟動 Docker Desktop。
2. 在 VS Code 安裝 Microsoft 官方 Docker 擴充套件。

在 Windows 上，建議把 Docker Desktop 切到 WSL 2 後端（Settings > Resources > WSL Integration），通常會更穩定、效能也更好。

02 準備 Dockerfile

如果專案裡還沒有 Dockerfile，可以讓 VS Code 直接產生：

1. 在 VS Code 開啟你的專案資料夾。
2. 按 F1 或 Ctrl+Shift+P 開啟命令面板。
3. 執行 Docker: Add Docker Files to Workspace。
4. 選擇你的平台（例如 Node.js、Python、.NET），依提示完成。

完成後通常至少會得到：

• Dockerfile
• .dockerignore

這一步的重點是先得到可運作的基礎版本，後續再依需求微調。

03 三種建置映像方式

方式 A：右鍵 Dockerfile

在檔案總管中右鍵 Dockerfile，選擇 Build Image...，再輸入映像標籤（tag）。

方式 B：命令面板

按 F1 執行 Docker: Build Image，再依提示選擇上下文與標籤。

方式 C：整合終端機

1

docker build -t your-image-name .

這條命令會用目前目錄當建置上下文，建立標籤為 your-image-name 的映像。

04 常見問題快速檢查

• Docker Desktop 未啟動：先確認程式正在執行。
• 建置很慢：優先檢查是否啟用 WSL 2 後端。
• 建置失敗顯示找不到檔案：確認執行目錄是專案根目錄，且檔案在建置上下文內。
• VS Code 看不到 Docker 資源：重啟 VS Code，並確認 Docker CLI 可用（docker version）。

小結

在 Windows 上用 VS Code 建置 Docker 映像並不困難。先完成 Docker Desktop 與擴充套件安裝，再用命令面板產生 Dockerfile，最後透過 UI 或 docker build 就能完成日常建置流程。