什麼是 VS Code 工作區？

Visual Studio Code 的工作區是在 VS Code 視窗 (執行個體) 中開啟的一個或多個資料夾的集合。在大多數情況下，您會開啟單一資料夾作為工作區。但是，根據您的開發工作流程，您可以使用名為多根工作區的進階組態，包含多個資料夾。

工作區的概念讓 VS Code 能夠

• 設定僅適用於特定資料夾而非其他資料夾的設定。
• 保存僅在該工作區的環境中有效的工作和偵錯工具啟動組態。
• 儲存和還原與該工作區相關聯的 UI 狀態 (例如，已開啟的檔案)。
• 僅針對該工作區選擇性地啟用或停用擴充功能。

您可能會在 VS Code 文件、問題和社群討論中看到「資料夾」和「工作區」這兩個詞彙交替使用。將工作區視為專案的根目錄，它具有額外的 VS Code 知識和功能。

注意：也可以在沒有工作區的情況下開啟 VS Code。例如，當您從平台的檔案選單中選取檔案來開啟新的 VS Code 視窗時，您不會在工作區內。在此模式下，VS Code 的某些功能會減少，但您仍然可以開啟文字檔並編輯它們。

如何開啟 VS Code「工作區」？

您可以使用檔案 > 開啟資料夾... 選單，然後選取資料夾來開啟工作區。

或者，如果您從終端機啟動 VS Code，您可以將資料夾的路徑作為第一個引數傳遞給 code 命令以開啟。例如，使用以下命令以 VS Code 開啟目前資料夾 (.)

code .

單一資料夾工作區

您不必為了讓資料夾成為 VS Code 工作區而執行任何動作，只需使用 VS Code 開啟資料夾即可。一旦您開啟資料夾，VS Code 就會自動追蹤組態，例如您開啟的檔案或編輯器版面配置。當您在 VS Code 中重新開啟該資料夾時，編輯器將會與您上次離開時的狀態相同。

您也可以新增其他資料夾特定的組態，例如工作區特定的設定 (相對於全域使用者設定)、工作定義和偵錯啟動檔案 (請參閱下方的工作區設定章節)。

在 VS Code 內開啟的單一資料夾工作區

多根工作區

多根工作區是 VS Code 的進階功能，可讓您將多個不同的資料夾設定為同一個工作區的一部分。您不是將資料夾開啟為工作區，而是開啟一個 <name>.code-workspace JSON 檔案，其中列出工作區的所有資料夾。例如

{
  "folders": [
    {
      "path": "my-folder-a"
    },
    {
      "path": "my-folder-b"
    }
  ]
}

在 VS Code 中開啟的多根工作區

注意：開啟資料夾與開啟 .code-workspace 檔案之間的視覺差異可能很細微。為了提示您已開啟 .code-workspace 檔案，使用者介面的某些區域 (例如，檔案總管的根目錄) 會在名稱旁邊顯示額外的 (工作區) 字尾。

未命名的多根工作區

您可以彈性地在工作區中新增或移除資料夾。從在 VS Code 中開啟資料夾開始，然後稍後在您認為合適時新增更多資料夾。

用於在工作區中新增或移除資料夾的檔案總管內容選單

除非您已開啟 .code-workspace 檔案，否則當您第一次將第二個資料夾新增至工作區時，VS Code 會自動建立未命名的工作區。在背景中，VS Code 會自動為您維護一個 untitled.code-workspace 檔案，其中包含目前工作階段中的所有資料夾和工作區設定。工作區保持未命名狀態，直到您決定將其儲存到磁碟。

在 VS Code 中開啟的未命名多根工作區

注意：未命名工作區和已儲存工作區之間沒有任何差異，除了未命名工作區是為了您的方便而自動建立，並且將始終還原，直到您儲存它。當您關閉開啟未命名工作區的視窗時，VS Code 會自動刪除未命名工作區 (在詢問您是否確認後)。

工作區設定

工作區設定可讓您在已開啟的工作區環境中設定設定。工作區設定始終會覆寫全域使用者設定。它們以 JSON 檔案格式實際儲存，其位置取決於您是將資料夾開啟為工作區，還是開啟 .code-workspace 檔案。

請參閱設定文件，以取得有關設定範圍及其檔案位置的完整說明。

單一資料夾工作區設定

當您將資料夾開啟為工作區時，工作區設定會儲存在 .vscode/settings.json 中。

當資料夾開啟為工作區時的設定編輯器

多根工作區設定

當您開啟 .code-workspace 作為工作區時，所有工作區設定都會新增到 .code-workspace 檔案中。

您仍然可以針對每個根資料夾設定設定，而且設定編輯器將會呈現第三個設定範圍，稱為資料夾設定

當開啟多根工作區時的設定編輯器

針對每個資料夾設定的設定會覆寫在 .code-workspace 中定義的設定。

工作區工作與啟動組態

與工作區設定如何特定於工作區類似，工作和啟動組態也可以限定在工作區範圍內。

根據您是開啟資料夾作為工作區還是 .code-workspace 檔案，工作區工作和啟動組態的位置位於 .vscode 資料夾內，或位於 .code-workspace 檔案內。此外，即使您已開啟 .code-workspace 檔案，工作和啟動組態始終可以在資料夾層級定義。

請參閱工作和偵錯章節，以取得有關如何在 VS Code 中使用工作和啟動組態的更完整概觀。

常見問題

多根工作區相較於資料夾有什麼優點？

最明顯的優點是多根工作區可讓您處理可能未儲存在磁碟上相同父資料夾內的多個專案。您可以從任何位置選取資料夾以新增至工作區。

即使您主要在以單一資料夾為基礎的專案中工作，您也可以受益於使用 .code-workspace 檔案。您可以在資料夾內儲存多個 .code-workspace 檔案，以根據情境提供專案特定方面的範圍資料夾檢視 (例如，client.code-workspace、server.code-workspace 以從檔案總管中篩選出不相關的資料夾)。由於 .code-workspace 檔案支援 folders 區段的相對路徑，因此這些工作區檔案適用於所有人，無論資料夾儲存在何處。

最後，如果對於某些專案，您想要套用相同的工作區設定集或工作/啟動組態，請考慮將這些新增到 .code-workspace 檔案中，並從該工作區新增或移除這些資料夾。

為什麼 VS Code 會在重新啟動時還原所有未命名的工作區？

未命名的工作區設計為您必須明確決定是否保留的東西。第一次建立未命名工作區時，VS Code 會將指定的資料夾新增到工作區檔案中，並新增所有現有的工作區設定。此使用者資料會始終還原並顯示在 VS Code 視窗中，直到未命名工作區儲存或刪除。

如何刪除未命名的工作區？

您可以關閉未命名工作區的視窗，並關閉儲存未命名工作區的提示來刪除它。

我可以不使用資料夾來使用多根工作區嗎？

可以將 .code-workspace 檔案的 folders 區段留空，這樣您最終會得到一個 VS Code 執行個體，其中不顯示任何根資料夾。在這種情況下，您仍然可以儲存工作區設定，甚至是工作或啟動組態。

VS Code 是否支援專案或方案？

VS Code 沒有「專案」或「方案」的概念，因為它們有時在其他開發工具 (例如 Visual Studio IDE) 中定義。您可能會在 VS Code 文件中看到「專案」一詞，但它通常表示「您正在處理的事物」。根據您的程式設計語言或架構，工具組本身可能會支援稱為「專案」的東西，以協助定義建置組態或列舉包含的檔案。