🚀 在 VS Code 中！

附加到執行中的容器

Visual Studio Code 可以為您建立和啟動容器，但這可能不符合您的工作流程，您可能偏好將 VS Code「附加」到已在執行的 Docker 容器，無論它是如何啟動的。一旦附加，您可以安裝擴充功能、編輯和偵錯，就像使用 devcontainer.json 在容器中開啟資料夾一樣。

附加到 Docker 容器

若要附加到 Docker 容器，請從命令面板 (F1) 選取 [開發容器: 附加到執行中的容器...]，或使用活動列中的 [遠端總管]，然後從 [容器] 檢視中，選取您要連線的容器上的 [附加到容器] 行內動作。

Containers Explorer screenshot

注意： 當使用 Alpine Linux 容器時，由於擴充功能內部原生程式碼中的 glibc 相依性，某些擴充功能可能無法運作。

附加的容器組態檔

VS Code 支援映像或容器名稱層級的組態檔，以加速您重複連線到指定 Docker 容器時的設定。一旦附加，每當您開啟資料夾、安裝擴充功能 或 轉送連接埠 時，本機映像特定組態檔將會自動更新以記住您的設定，以便您再次附加時，一切都會回到正確的位置。

  • 依預設，會使用映像層級組態。若要在附加後檢視或更新它，請從命令面板 (F1) 選取 [開發容器: 開啟容器組態檔]。

  • 如果您偏好將組態繫結到容器名稱，請在附加後從命令面板 (F1) 選取 [開發容器: 開啟具名組態檔]。從此時起的所有更新都會套用至此名稱層級組態，而不是映像層級。

這兩個檔案都支援 devcontainer.json 屬性的子集

{
  // Default path to open when attaching to a new container.
  "workspaceFolder": "/path/to/code/in/container/here",

  // Set *default* container specific settings.json values on container create.
  "settings": {
    "terminal.integrated.defaultProfile.linux": "bash"
  },

  // Add the IDs of extensions you want installed when the container is created.
  "extensions": ["dbaeumer.vscode-eslint"],

  // An array port numbers to forward
  "forwardPorts": [8000],

  // Container user VS Code should use when connecting
  "remoteUser": "vscode",

  // Set environment variables for VS Code and sub-processes
  "remoteEnv": { "MY_VARIABLE": "some-value" }
}

請參閱 附加的容器組態參考，以取得屬性的完整清單及其用途。

儲存後，每當您第一次使用相同的映像/容器名稱開啟容器時，這些屬性將會用來設定環境。

提示： 如果您的組態有問題，您也可以在未附加到容器時編輯它，方法是從命令面板 (F1) 選取 [開發容器: 開啟附加的容器組態檔...]，然後從顯示的清單中選取映像/容器名稱。

最後，如果您有想要安裝的擴充功能，無論您附加到哪個容器，您可以更新 settings.json 以指定應永遠安裝的擴充功能清單。

附加的容器組態參考

附加的容器組態檔類似於 devcontainer.json，並支援其屬性的子集。

屬性 類型 描述
workspaceFolder 字串 設定 VS Code 連線到容器時應開啟的預設路徑 (通常是磁碟區掛接的路徑，原始程式碼可以在容器中找到)。預設為未設定 (會開啟空白視窗)。
extensions 陣列 擴充功能識別碼的陣列，指定在建立容器時應在容器內安裝的擴充功能。預設為 []。
settings 物件 將預設 settings.json 值新增到容器/機器特定的設定檔中。
forwardPorts 陣列 應從容器內部轉送到本機機器的連接埠清單。
portsAttributes 物件 將連接埠號碼、"host:port" 值、範圍或規則運算式對應到一組預設選項的物件。請參閱 連接埠屬性，以取得可用的選項。例如
"portsAttributes": {"3000": {"label": "應用程式連接埠"}}
otherPortsAttributes 物件 未使用 portsAttributes 設定的連接埠、連接埠範圍和主機的預設選項。請參閱 連接埠屬性，以取得可用的選項。例如
"otherPortsAttributes": {"onAutoForward": "silent"}
remoteEnv 物件 一組名稱-值配對，設定或覆寫 VS Code (或子程序，例如終端機) 的環境變數，但不會設定容器整體。環境和 預先定義的變數 可以在值中參考。
例如："remoteEnv": { "PATH": "${containerEnv:PATH}:/some/other/path" }
remoteUser 字串 覆寫 VS Code 在容器中執行的使用者 (以及子程序，例如終端機、工作或偵錯)。預設為容器整體執行的使用者 (通常為 root)。
userEnvProbe 列舉 指出要用於「探查」使用者環境變數以包含在 VS Code 或其他連線工具程序中的 Shell 類型：none、interactiveShell、loginShell 或 loginInteractiveShell (預設值)。使用的特定 Shell 是根據使用者的預設 Shell (通常為 bash)。例如，bash 互動式 Shell 通常會包含在 /etc/bash.bashrc 和 ~/.bashrc 中設定的變數，而登入 Shell 通常會包含來自 /etc/profile 和 ~/.profile 的變數。將此屬性設定為 loginInteractiveShell 將會從所有四個檔案取得變數。
postAttachCommand 字串，
陣列		 在 VS Code 附加到容器後執行的命令字串或命令引數清單。在字串中使用 && 來執行多個命令。例如，"yarn install" 或 "apt-get update && apt-get install -y curl"。陣列語法 ["yarn", "install"] 將會直接叫用命令 (在本例中為 yarn)，而不會使用 Shell。預設為未設定。
請注意，陣列語法將會在沒有 Shell 的情況下執行命令。您可以深入瞭解字串與陣列屬性的格式化。

附加的容器組態檔中的變數

變數可以在附加的組態檔中的特定字串值中參考，格式如下：${variableName}。下表是您可以使用的可用變數清單。

變數 屬性 描述
${containerEnv:VAR_NAME} remoteEnv 容器內部現有環境變數的值 (在本例中為 VAR_NAME)，一旦容器啟動並執行。例如："remoteEnv": { "PATH": "${containerEnv:PATH}:/some/other/path" }

附加到 Kubernetes 叢集中的容器

若要附加到 Kubernetes 叢集中的容器，請從命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 選取 [開發容器: 附加到執行中的 Kubernetes 容器...]。或者，先安裝 Kubernetes 擴充功能 和 kubectl 以及開發容器擴充功能。然後從活動列選取 Kubernetes 總管，並展開叢集和 Pod，其中包含您要附加到的容器。最後，在容器上按一下滑鼠右鍵，然後從內容功能表選取 [附加 Visual Studio Code]。

注意： 附加的容器組態檔尚不支援 Kubernetes 叢集中的容器。

Attach to Kubernetes Container

後續步驟

02/06/2025