vs code 連接 docker 容器進行開發的核心方法是使用 remote – containers 插件。1. 安裝 docker 和 remote – containers 插件；2. 創建定義環境的 dockerfile；3. 配置 .devcontainer/devcontainer.JSon 文件指定構建路徑、端口轉發、設置和插件；4. 在 vs code 中打開項目并使用 “reopen in container” 命令連接容器；5. 等待構建完成后開始開發，所有工具和依賴在容器內運行。若連接失敗，應檢查 docker 狀態、配置文件、輸出日志、網絡及端口設置。安裝額外依賴推薦修改 dockerfile 并重建鏡像以確保一致性。調試時只需正常配置 launch.json，vs code 會自動在容器內啟動調試會話。
VS Code 連接 Docker 容器進行開發，核心在于利用 VS Code 的 Remote – Containers 插件，讓你在容器內部進行編碼、調試，就像在本地一樣。這能解決環境一致性問題，避免“在我機器上可以運行”的尷尬。
Remote – Containers 插件是關鍵。安裝后，VS Code 可以直接操作 Docker 容器。
解決方案
-
安裝 Docker 和 VS Code Remote – Containers 插件: 確保你的機器上安裝了 Docker，并且在 VS Code 中安裝了 Remote – Containers 插件。
-
創建 Dockerfile (如果還沒有): Dockerfile 定義了你的開發環境。一個簡單的 Node.js 應用的 Dockerfile 可能是這樣的：
FROM node:16 WORKDIR /app COPY package*.json ./ RUN npm install COPY . . EXPOSE 3000 CMD ["npm", "start"]
-
創建 devcontainer.json 文件: 這個文件告訴 VS Code 如何連接到你的 Docker 容器。在項目根目錄下創建一個 .devcontainer 文件夾，并在其中創建一個 devcontainer.json 文件。
{ "name": "Node.js Dev Container", "build": { "dockerfile": "Dockerfile" }, "forwardPorts": [3000], "settings": { "terminal.integrated.shell.linux": "/bin/bash" }, "extensions": [ "dbaeumer.vscode-eslint", "esbenp.prettier-vscode" ] }- name: 容器的名稱。
- build.dockerfile: Dockerfile 的路徑。
- forwardPorts: 需要暴露的端口。
- settings: VS Code 的設置，比如終端 shell。
- extensions: 推薦安裝的 VS Code 插件。
-
打開項目文件夾: 在 VS Code 中打開你的項目文件夾。
-
使用 Remote-Containers: Reopen in Container 命令: VS Code 會自動檢測到 .devcontainer.json 文件，并提示你 “Reopen in Container”。如果沒有提示，可以使用命令面板 (Ctrl+Shift+P 或 Cmd+Shift+P) 搜索 “Remote-Containers: Reopen in Container” 并執行。
-
等待容器構建和啟動: VS Code 會構建 Docker 鏡像，啟動容器，并連接到容器內部。這個過程可能需要一些時間，取決于你的 Dockerfile 的復雜程度。
-
開始開發: 一旦連接成功，你就可以在 VS Code 中像在本地一樣進行開發了。所有的代碼都在容器內部運行，所有的工具和依賴也都已經安裝在容器內部。
容器連接失敗，如何排查？
首先檢查 Docker 是否運行正常。然后檢查 .devcontainer.json 文件是否正確配置。仔細查看 VS Code 的輸出面板，通常會有詳細的錯誤信息。網絡問題也可能導致連接失敗，確保你的網絡連接正常，并且 Docker 容器可以訪問外部網絡。如果端口轉發配置錯誤，也會導致連接失敗。
如何在容器中安裝額外的依賴？
有兩種方法。一種是直接修改 Dockerfile，添加安裝依賴的命令，然后重新構建鏡像。另一種是在容器內部使用終端安裝依賴。推薦使用第一種方法，因為這樣可以確保你的開發環境是可重復的。
如何調試容器中的代碼？
VS Code 的調試功能可以無縫地與 Remote – Containers 插件集成。你只需要像在本地一樣配置調試器，然后在 VS Code 中啟動調試會話。VS Code 會自動連接到容器內部，并允許你設置斷點、單步執行代碼、查看變量等等。確保你的 launch.json 文件配置正確，以便 VS Code 可以找到你的代碼和調試器。
