什麼是 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檔案,使用者介面的某些區域 (例如檔案總管的根目錄) 會在名稱旁邊顯示額外的 (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 說明文件中看到使用「專案」一詞,但它通常是指「您正在處理的事物」。根據您的程式語言或架構,工具組本身可能會支援稱為「專案」的功能,以協助定義建置組態或列舉包含的檔案。