練習 - 建立、建置和執行應用程式

已完成

.NET 軟體開發套件 (SDK) 包含可從 Visual Studio Code 的整合式終端存取的命令列介面 (CLI)。 在此訓練期間,您會使用 .NET CLI 命令來建立新的主控台應用程式、建置專案程式碼,以及執行您的應用程式。

例如,下列 .NET CLI 命令會在指定的資料夾位置建立新的主控台應用程式:

dotnet new console -o ./CsharpProjects/TestProject

CLI 命令的結構包含下列三個部分:

  • 驅動程式:本範例中的 dotnet
  • 命令:本範例中的 new console
  • 命令引數:本範例中的 -o ./CsharpProjects/TestProject

注意

命令引數是可用來提供其他資訊的選擇性參數。 不需要指定選擇性的資料夾位置便能執行上述命令。 例如: dotnet new console 。 本案例會在目前的資料夾位置建立新的主控台應用程式。

在本練習中,您會使用 Visual Studio Code 來建立新的專案資料夾、使用 CLI 命令建立新的主控台應用程式、在 Visual Studio Code 編輯器中自訂應用程式,然後建置和執行您的應用程式。

在指定資料夾建立 C# 主控台應用程式

首先,您要在容易找到和重複使用的資料夾位置建立主控台應用程式。

  1. 確定您已開啟 Visual Studio Code

    您可以使用 Windows 的 [開始] 功能表尋找並開啟 Visual Studio Code。

  2. 在 Visual Studio Code 的 [檔案] 功能表上,選取 [開啟資料夾]。

    隨即會顯示 [開啟資料夾] 對話方塊。 您可以使用 [開啟資料夾] 對話方塊為 C# 專案建立新資料夾。

    注意

    如果您在個人電腦上工作,而且有用於編碼專案的資料夾位置,則可以使用 [開啟資料夾] 對話方塊來瀏覽至所需的資料夾位置。

  3. 在 [開啟資料夾] 對話方塊中,瀏覽至 Windows Desktop 資料夾。

    如果您在不同的資料夾位置中保留程式碼專案,您可以改用該資料夾位置。 針對本訓練,請務必使用容易找到並記住的位置。

  4. 在 [開啟資料夾] 對話方塊中,選取 [選取資料夾]。

    如果您看到詢問您是否信任作者的安全性對話方塊,請選取 [是]。

  5. 在 Visual Studio Code 的 [終端] 功能表上,選取 [新增終端]。

    螢幕擷取畫面:顯示 Visual Studio Code 終端面板中的命令提示字元。

    請注意,終端面板中的命令提示字元會顯示目前資料夾的資料夾路徑。 例如:

    C:\Users\someuser\Desktop>
    
  6. 在終端的命令提示字元中,若要在指定的資料夾建立新的主控台應用程式,請輸入下列命令:

    dotnet new console -o ./CsharpProjects/TestProject
    

    螢幕擷取畫面:顯示正在 Visual Studio Code 終端面板中輸入的命令。

    這個 .NET CLI 命令會使用 .NET 程式範本,在指定的資料夾位置中建立新的 C# 主控台應用程式專案。 這個命令會為您建立 CsharpProjects 和 TestProject 資料夾,並使用 TestProject 做為 .csproj 檔案的名稱。

  7. 在EXPLORER檢視中,展開 CsharpProjects 資料夾。

    您應該會看到 TestProject 資料夾和兩個檔案:名為 Program.cs 的 C# 應用程式檔案,以及名為 TestProject.csproj 的 C# 專案檔。 CLI 命令會在建立至專案檔案 (TestProject.csproj) 時使用資料夾名稱。 Program.cs 檔案是包含 C# 程式碼的檔案。

  8. 在 [探索者視圖] 中,若要在 [編輯器] 面板中檢視 C# 程式代碼,請選取 Program.cs

    如您所見,預設主控台應用程式是標誌性的「Hello World!」 應用程式。

    // See https://aka.ms/new-console-template for more information
    Console.WriteLine("Hello, World!");
    

    此應用程式使用 Console.WriteLine() 方法在主控台視窗中顯示「Hello, World!」。

更新、建置和執行應用程式

在這項工作中,您會使用 [總管] 檢視開啟程式碼專案資料夾、自訂「Hello」訊息,然後執行應用程式。

  1. 在 Visual Studio Code 的 [總管] 檢視中,以滑鼠右鍵按一下 [TestProject] 資料夾,然後選取 [在整合式終端中開啟]。

    螢幕擷取畫面:顯示正在 Visual Studio Code 整合式終端面板中輸入的命令。

    重要

    整合式終端面板中的命令提示字元會顯示將執行命令的資料夾位置。 在執行 buildrun 命令之前,必須先確定終端已開啟至專案資料夾。

  2. 確認終端面板中的命令提示字元顯示下列資料夾路徑:

    C:\Users\someuser\Desktop\CsharpProjects\TestProject>
    
  3. 在 Visual Studio Code 編輯器中更新 Console.WriteLine() 方法,如下所示:

    Console.WriteLine("Hello C#!");
    

    第一次編輯 .cs 檔案時,Visual Studio Code 可能會提示您新增遺漏的資產,以建置應用程式並加以偵錯。 如果您看到此提示,則可以選取 [是]。

  4. 在 [檔案] 功能表上,選取 [儲存]

    您一律必須將程式碼變更儲存至檔案。 要等到程式碼儲存後,程式碼編譯器才有辦法辨識您在編輯器中所做的程式碼變更。

  5. 若要編譯應用程式的組建,請在終端的命令提示字元中輸入下列命令:

    dotnet build
    

    螢幕擷取畫面:顯示正在 Visual Studio Code 終端面板中輸入的 dotnet build 命令。

    dotnet build 命令會將專案及其相依性建置成一組二進位檔。 二進位檔會在副檔名為 .dll 的中繼語言 (IL) 檔案中包含專案的程式碼。 視專案類型和設定而定,二進位檔中也可能會包含其他檔案。 如果您好奇,您可以在 EXPLORER 檢視中找到 TestProject.dll 檔案,其資料夾位置類似下列路徑:

    C:\Users\someuser\Desktop\CsharpProjects\TestProject\bin\Debug\net7.0\

    注意

    您的資料夾路徑會反映您的帳戶和 TestProject 資料夾的資料夾路徑。

  6. 若要執行應用程式,請在終端的命令提示字元中輸入下列命令:

    dotnet run
    

    dotnet run 命令會在沒有任何明確的編譯或啟動命令的情況下執行原始程式碼。 其提供了方便的選項,可讓您使用一個命令就從原始程式碼執行應用程式。 其適合從命令列進行的快速反覆式開發法。 此命令會依靠 dotnet build 命令來建置程式碼。

  7. 請注意,Hello C# 會在 [終端] 面板中顯示於 dotnet run 命令下方那行。

    如果您看到畫面上顯示「Hello, World!」,請確定您已儲存程式碼變更。

恭喜,您已完成 Visual Studio Code 的設定,並已完成簡單程式碼的建置和執行!