參加你附近的 ,瞭解 VS Code 中的 AI 輔助開發。

專案管理

當你在 Visual Studio Code 中建立 C# 應用程式時,你會從一個專案開始。專案包含所有被編譯成可執行檔案、庫或網站的檔案(例如原始碼、影像等)。然後,你所有相關的專案都可以儲存在一個名為解決方案的容器中。本文將向你展示如何透過解決方案資源管理器檢視來維護你所有的專案及其各自的檔案。

注意:需要 C# Dev Kit 擴充套件才能在 VS Code 中使用“解決方案資源管理器”檢視。

解決方案資源管理器

新的 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

你也可以在命令面板中呼叫此命令。你可以使用 ⇧⌘P (Windows, Linux Ctrl+Shift+P) 開啟命令面板。如下圖所示。

Close solution from the Command Palette

關閉解決方案後,“解決方案資源管理器”將顯示一個按鈕,以便你以後可以從工作區開啟解決方案檔案。你也可以使用 .NET: Open Solution (.NET: 開啟解決方案) 命令在命令面板中呼叫該命令。

當你呼叫 Open Solution (開啟解決方案) 命令時,如果工作區中只有一個解決方案檔案,它將自動載入該檔案。當有多個解決方案檔案時,系統會提示你選擇要載入的解決方案檔案。這與你首次開啟一個包含一個或多個解決方案檔案的工作區的體驗相同。接下來讓我們討論“解決方案資源管理器”中對“解決方案資料夾”的支援。

解決方案資料夾

在“解決方案資源管理器”中,如果解決方案包含“解決方案資料夾”(用於在解決方案中對專案進行分組的虛擬資料夾),它們將被顯示出來。在這裡,你可以與“解決方案資料夾”的內容進行互動。要新增新的“解決方案資料夾”,你可以右鍵單擊解決方案並選擇 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 中通常那樣建立檔案,並將它們儲存在包含專案檔案的資料夾下,來將檔案新增到專案中。預設情況下,新增到專案資料夾的新檔案將自動新增到專案中。

在專案檢視中,你還可以看到專案具有的依賴項,包括專案引用包引用。在此版本的 C# Dev Kit 中,你無法修改依賴項。要向專案或包引用新增依賴項,你可以使用 dotnet add 命令列工具。要新增包引用,請參閱 dotnet add package 命令 - .NET CLI;要新增專案引用,請參閱 dotnet add reference 命令 - .NET CLI。要移除引用,請使用 dotnet remove。你可以在如何移除專案引用如何移除包中閱讀更多資訊。

如果你想檢視或編輯專案檔案,請在“解決方案資源管理器”中選擇專案節點,專案檔案將在編輯器中開啟。這與你在“解決方案資源管理器”中選擇檔案的行為相同。

使用“解決方案資源管理器”,你還可以使用上下文選單執行諸如生成重新生成清理等常見操作。當你在“解決方案資源管理器”中選擇解決方案節點或專案節點時,你將看到這些上下文選單。這將生成/重新生成/清理所選專案及其依賴項。