專案管理

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

注意:在 VS Code 中使用方案總管檢視需要安裝 C# Dev Kit 擴充功能

方案總管 (Solution Explorer)

新的 C# Dev Kit 擴充功能在主要側邊欄中包含一個名為方案總管的新檢視。此檢視提供了您的應用程式、其方案及專案的結構化檢視,方便您進行集中式的專案管理。當您開啟包含 .NET 方案檔或專案檔的工作區時,方案總管會自動出現。

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

Open workspace with 1 solution file

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

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

Open workspace with multiple solution files

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

當您在方案總管中載入方案並希望關閉它時,可以使用關閉方案 (Close Solution) 指令。您可以在方案總管中對方案按右鍵,從快顯功能表中找到此指令。

Close solution context menu

您也可以在命令選擇區 (Command Palette) 中叫用此指令。您可以透過 ⇧⌘P (Windows, Linux Ctrl+Shift+P) 開啟命令選擇區。如下圖所示。

Close solution from the Command Palette

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

當您叫用 Open Solution 指令時,如果工作區中只有一個方案檔,它會自動載入;若有多個方案檔,則會提示您選擇要載入的方案檔。這與您第一次開啟包含一個或多個方案檔之工作區時的體驗相同。現在,讓我們繼續討論方案總管對方案資料夾的支援。

方案資料夾 (Solution Folders)

在方案總管中,如果方案包含方案資料夾(用於將方案中的專案分組的虛擬資料夾),它們將會顯示出來。在這裡,您可以與方案資料夾的內容進行互動。若要新增方案資料夾,您可以對方案按右鍵並選取新增方案資料夾 (New Solution Folder) 功能表項目。請參考下方的短片。

C# Dev Kit new solution folder

在上面的影片中,建立了一個名為 "tests" 的新方案資料夾。建立方案資料夾後,您可以透過加入現有專案 (Add Existing Project) 快顯功能表將專案加入其中。下方的動畫展示了此操作。

Add existing project

您也可以透過下圖中所示的加入新檔案 (Add New File) 快顯功能表,將新檔案加入方案資料夾。

Add file to solution folder

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

Add new file from Command Palette

此列表顯示了擴充功能目前支援方案資料夾的檔案範本。若要建立不使用範本的檔案(建立空白檔案),請選取自訂檔案 (無範本) (Custom file (without template))

若要移除方案資料夾,您可以使用移除 (Remove) 快顯功能表選項。

Remove Solution Folder

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

使用專案

在方案總管中,有許多功能可讓您處理專案。當您第一次開啟方案時,會看到專案和方案資料夾。您可以展開方案資料夾或專案以檢視其內容。下圖顯示了展開部分節點後的方案總管。

Solution Explorer with expanded nodes

在上圖中,我們可以看到方案總管展開了幾個方案資料夾,以及 TemplatesWeb 專案。此版本中僅支援最基本的檔案巢狀顯示,我們將會在後續擴充此支援,使其與 Visual Studio IDE 中的檔案巢狀結構更為一致。

在此,您可以透過在方案總管中按兩下檔案來開啟它們。您也可以在方案總管中的項目上按右鍵,以取得該項目的特定功能表及可用動作。例如,若要將新檔案加入專案,請在專案上按右鍵並選取加入新檔案 (Add New File)。選取該選項後,系統會提示您選擇用於預設內容的檔案範本。如果您使用的是以 .NET 7.0.200 或更新版本為目標的專案,您將獲得最佳的體驗。

您也可以透過在 VS Code 中以一般方式建立檔案,並將其儲存在包含專案檔的資料夾下,來將檔案加入專案。預設情況下,加入專案資料夾的新檔案會自動新增至專案中。

在專案檢視中,您也可以查看專案的相依性,包含專案參考 (Project References) 以及套件參考 (Package References)。在此版本的 C# Dev Kit 中,您無法直接修改這些相依性。若要加入專案參考或套件參考的相依性,您可以使用 dotnet add 命令列工具。若要加入套件參考,請參閱 dotnet add package 指令 - .NET CLI;若要加入專案參考,請參閱 dotnet add reference 指令 - .NET CLI。若要移除參考,請使用 dotnet remove。您可以閱讀更多相關資訊:如何移除套件參考 以及 如何移除套件

如果您想要查看或編輯專案檔,請選取方案總管中的「專案」節點,該專案檔便會在編輯器中開啟。這與在方案總管中選取一般檔案時的行為相同。

使用方案總管,您還可以透過快顯功能表執行建置 (Build)重建 (Rebuild)清除 (Clean) 等常見動作。當您在方案總管中選取方案節點或專案節點時,就會看到這些快顯功能表。這將會建置/重建/清除選取的項目及其相依項目。

© . This site is unofficial and not affiliated with Microsoft.