專案管理

當您在 Visual Studio Code 中建立 C# 應用程式時,會從一個專案開始。專案包含所有檔案 (例如原始碼、影像等),這些檔案會編譯成可執行檔、程式庫或網站。您所有相關的專案接著可以儲存在一個稱為方案的容器中。本文說明如何透過方案總管檢視來維護您的所有專案及其各自的檔案。

注意:使用 VS Code 中的方案總管檢視需要安裝 C# 開發套件擴充功能

方案總管

全新的 C# 開發套件擴充功能在主要側邊欄中包含一個新的檢視,即方案總管。此檢視提供您的應用程式、其方案和專案的結構化檢視,以便輕鬆進行集中式專案管理。當您開啟包含 .NET 方案檔或專案檔的工作區時,方案總管會自動顯示。

如果您的工作區中只有一個方案檔 (.sln 檔),方案總管會在工作區載入後偵測到該檔案並自動載入。例如,請參考以下動畫,其中顯示開啟包含單一方案檔的工作區的體驗。

Open workspace with 1 solution file

在上述動畫中,工作區是第一次載入到 VS Code 中。工作區載入後,方案總管會偵測到單一的 .sln 檔案並自動載入。

當您的工作區中有多個方案檔時,系統會提示您選取要載入的特定方案檔。在工作區載入方案檔後,擴充功能會記住上次載入的方案檔,並在 VS Code 中載入工作區時自動重新載入該檔案。在以下動畫中,您可以看到第一次開啟包含多個方案檔的工作區的體驗。

Open workspace with multiple solution files

在上方影片中,工作區載入後,方案總管會偵測到工作區包含多個方案檔,並且系統會提示您使用標準 VS Code 通知選取要載入的方案。往後當您開啟相同的工作區時,方案總管會記住上次載入的方案檔並自動重新載入。

當您在方案總管中載入方案,並且想要關閉該方案時,可以使用「關閉方案」命令。您可以在方案總管中方案上按一下滑鼠右鍵時出現的 контекст 菜单中找到此命令。

Close solution context menu

您也可以在命令選擇區中叫用此命令。您可以使用 ⇧⌘P (Windows, Linux Ctrl+Shift+P) 開啟命令選擇區。這會在下圖中顯示。

Close solution from the Command Palette

關閉方案後,方案總管會顯示一個按鈕,以便您稍後從工作區開啟方案檔。您也可以使用命令選擇區和「.NET: 開啟方案」命令來叫用該命令。

當您叫用「開啟方案」命令時,如果工作區中只有一個方案檔,它會自動載入該檔案。當有多個方案檔時,系統會提示您選取要載入的方案檔。這與您第一次開啟包含一個或多個方案檔的工作區時的體驗相同。接下來,讓我們繼續討論方案總管中對方案資料夾的支援。

方案資料夾

在方案總管中,如果方案包含方案資料夾 (用於在方案中群組專案的虛擬資料夾),則會顯示這些資料夾。您可以在此處與方案資料夾內容互動。若要新增方案資料夾,您可以按一下滑鼠右鍵選取方案,然後選取「新增方案資料夾」功能表項目。請參考以下短片。

C# Dev Kit new solution folder

在上方影片中,建立了一個名為「tests」的新方案資料夾。建立方案資料夾後,您可以使用「新增現有專案」 контекст 菜单將專案新增至其中。以下動畫顯示了此體驗。

Add existing project

您也可以使用下圖中顯示的「新增檔案」 контекст 菜单將新檔案新增至方案資料夾。

Add file to solution folder

在您叫用此命令後,系統會提示您在命令選擇區中選取要使用的檔案範本。下圖顯示了此畫面。

Add new file from Command Palette

此清單顯示擴充功能目前針對方案資料夾支援的檔案範本。若要建立不使用範本的檔案 (建立空白檔案),請選取「自訂檔案 (不使用範本)」。

若要移除方案資料夾,您可以使用「移除」 контекст 菜单選項。

Remove Solution Folder

當您從方案中移除方案資料夾時,方案資料夾及其內容會從方案中移除。它包含的檔案和/或專案不會從磁碟中刪除。現在我們已經討論了方案資料夾,接下來讓我們繼續查看如何在方案總管中與專案進行更多互動。

使用專案

在方案總管中,有許多功能可讓您使用專案。當您第一次開啟方案時,會看到專案和方案資料夾。您可以展開方案資料夾或專案以查看其內容。下圖顯示了展開了幾個節點的方案總管。

Solution Explorer with expanded nodes

在上圖中,我們可以看到方案總管展開了幾個方案資料夾,以及 TemplatesWeb 專案。此版本中僅支援最基本的文件巢狀結構,我們將擴展該支援,使其更符合 Visual Studio IDE 中所見的文件巢狀結構。

從這裡,您可以透過在方案總管中按兩下檔案來開啟檔案。您也可以在方案總管中按一下滑鼠右鍵項目,以取得可用動作的 контекст 菜单。例如,若要將新檔案新增至專案,請在專案上按一下滑鼠右鍵,然後選取「新增檔案」。當您選取該選項時,系統會提示您選擇用於預設內容的檔案範本。如果您正在處理以 .NET 7.0.200 或更高版本為目標的專案,您將在此處獲得最佳體驗。

您也可以將檔案新增至專案中,方法是在 VS Code 中以正常方式建立檔案,並將其儲存在包含專案檔的資料夾下。根據預設,新增至專案資料夾的新檔案會自動新增至專案。

在專案檢視中,您也可以看到專案的相依性,包括專案參考套件參考。在此版本的 C# 開發套件中,您無法修改相依性。若要將相依性新增至專案或套件參考,您可以使用 dotnet add 命令列工具。若要新增套件參考,請參閱 dotnet add package command - .NET CLI,若要新增專案參考,請參閱 dotnet add reference command - .NET CLI。若要移除參考,請使用 dotnet remove。您可以在 how to remove a package referencehow to remove a package 中閱讀更多資訊。

如果您想要檢視或編輯專案檔,請在方案總管中選取 [專案] 節點,專案檔將會在編輯器中開啟。這與您在方案總管中選取檔案時會找到的行為相同。

使用方案總管,您也可以使用 контекст 菜单執行常見動作,例如「建置」、「重建」和「清除」。當您在方案總管中選取 [方案] 節點或 [專案] 節點時,將會看到這些 контекст 菜单。這將會建置/重建/清除選取的項目及其相依性。