除錯容器化應用程式

Container Tools 擴充功能針對容器內應用程式的除錯提供了更多支援，例如透過 Scaffolding (鷹架) 產生 launch.json 設定，以便將偵錯工具附加至容器內執行的應用程式。

Container Tools 擴充功能提供了一個 docker 除錯設定提供者，用以管理 VS Code 如何啟動應用程式及/或將偵錯工具附加至正在執行的容器中的應用程式。此提供者透過 launch.json 中的項目進行設定，且設定內容會針對該提供者所支援的各個應用程式平台而有所不同。

Container Tools 擴充功能目前支援在容器內對 Node.js、Python 和 .NET 應用程式進行除錯。

必要條件

僅透過 Scaffolding 或貼上除錯設定至 launch.json 是不足以建置並對容器進行除錯的。若要成功執行容器除錯設定，您必須具備：

• 一個 Dockerfile。
• tasks.json 中的 docker-build 和 docker-run 工作。
• 一個呼叫這些工作的除錯設定。

若這些資產尚未存在，我們建議使用 Containers: Add Docker Files to Workspace... 指令來建立它們。如果您已經有一個功能正常的 Dockerfile，我們建議使用 Containers: Initialize for container debugging 指令來產生除錯設定與容器相關工作。

Node.js

關於在容器內對 Node.js 應用程式進行除錯的更多資訊，請參閱 在容器內進行 Node.js 除錯。

用於對 Node.js 應用程式進行除錯的 launch.json 設定範例

{
  "configurations": [
    {
      "name": "Containers: Node.js Launch",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "platform": "node"
    }
  ]
}

Python

關於在容器內對 Python 應用程式進行除錯的更多資訊，請參閱 在容器內進行 Python 除錯。

用於對 Python 應用程式進行除錯的 launch.json 設定範例

{
  "configurations": [
    {
      "name": "Containers: Python - Django",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "python": {
        "pathMappings": [
          {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/app"
          }
        ],
        "projectType": "django"
      }
    }
  ]
}

.NET

您可以在容器內建置與除錯專案時選擇兩種方式

• 使用 .NET SDK：如果您熟悉 MSBuild 或希望在沒有 Dockerfile 的情況下容器化您的專案，這是建議的選項。

  注意：此選項僅適用於 .NET SDK 7 及以上版本，並使用 dotnet publish 指令來建置映像檔。

• 使用 Dockerfile：如果您偏好使用 Dockerfile 自訂您的專案，請選擇此選項。

關於這兩個選項的更多詳細資料，請參閱 在容器內進行 .NET 除錯。

使用 Dockerfile 對 .NET 應用程式進行除錯的 launch.json 設定範例

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Containers: .NET Launch",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "Run Container",
      "netCore": {
        "appProject": "${workspaceFolder}/project.csproj"
      }
    }
  ]
}

設定參考

dockerServerReadyAction 物件屬性

node 物件屬性

這些屬性與 VS Code 文件中所描述用於將偵錯工具附加至 Node.js 應用程式的屬性相同。所有傳入 node 物件的屬性都會被傳遞至 Node.js 除錯轉接器，即使未明確列於下方亦然。

python 物件屬性

netCore 物件屬性

傳入 netCore 物件的屬性通常會被傳遞至 .NET 除錯轉接器，即使未明確列於下方亦然。完整的偵錯工具屬性列表請參閱 OmniSharp VS Code 擴充功能文件。

後續步驟

繼續閱讀以深入了解：

• 在容器內對 Node.js 進行除錯
• 在容器內對 Python 進行除錯
• 在容器內對 .NET 進行除錯
• 使用 Docker Compose 進行除錯
• 疑難排解