練習 - 建立、建置和執行應用程式
.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# 主控台應用程式
首先,您要在容易找到和重複使用的資料夾位置建立主控台應用程式。
確定您已開啟 Visual Studio Code。
您可以使用 Windows 的 [開始] 功能表尋找並開啟 Visual Studio Code。
在 Visual Studio Code 的 [檔案] 功能表上,選取 [開啟資料夾]。
隨即會顯示 [開啟資料夾] 對話方塊。 您可以使用 [開啟資料夾] 對話方塊為 C# 專案建立新資料夾。
注意
如果您在個人電腦上工作,而且有用於編碼專案的資料夾位置,則可以使用 [開啟資料夾] 對話方塊來瀏覽至所需的資料夾位置。
在 [開啟資料夾] 對話方塊中,瀏覽至 Windows Desktop 資料夾。
如果您在不同的資料夾位置中保留程式碼專案,您可以改用該資料夾位置。 針對本訓練,請務必使用容易找到並記住的位置。
在 [開啟資料夾] 對話方塊中,選取 [選取資料夾]。
如果您看到詢問您是否信任作者的安全性對話方塊,請選取 [是]。
在 Visual Studio Code 的 [終端] 功能表上,選取 [新增終端]。
請注意,終端面板中的命令提示字元會顯示目前資料夾的資料夾路徑。 例如:
C:\Users\someuser\Desktop>
在終端的命令提示字元中,若要在指定的資料夾建立新的主控台應用程式,請輸入下列命令:
dotnet new console -o ./CsharpProjects/TestProject
這個 .NET CLI 命令會使用 .NET 程式範本,在指定的資料夾位置中建立新的 C# 主控台應用程式專案。 這個命令會為您建立 CsharpProjects 和 TestProject 資料夾,並使用 TestProject 做為
.csproj
檔案的名稱。在EXPLORER檢視中,展開 CsharpProjects 資料夾。
您應該會看到 TestProject 資料夾和兩個檔案:名為 Program.cs 的 C# 應用程式檔案,以及名為 TestProject.csproj 的 C# 專案檔。 CLI 命令會在建立至專案檔案 (TestProject.csproj) 時使用資料夾名稱。 Program.cs 檔案是包含 C# 程式碼的檔案。
在 [探索者視圖] 中,若要在 [編輯器] 面板中檢視 C# 程式代碼,請選取 Program.cs。
如您所見,預設主控台應用程式是標誌性的「Hello World!」 應用程式。
// See https://aka.ms/new-console-template for more information Console.WriteLine("Hello, World!");
此應用程式使用
Console.WriteLine()
方法在主控台視窗中顯示「Hello, World!」。
更新、建置和執行應用程式
在這項工作中,您會使用 [總管] 檢視開啟程式碼專案資料夾、自訂「Hello」訊息,然後執行應用程式。
在 Visual Studio Code 的 [總管] 檢視中,以滑鼠右鍵按一下 [TestProject] 資料夾,然後選取 [在整合式終端中開啟]。
重要
整合式終端面板中的命令提示字元會顯示將執行命令的資料夾位置。 在執行
build
或run
命令之前,必須先確定終端已開啟至專案資料夾。確認終端面板中的命令提示字元顯示下列資料夾路徑:
C:\Users\someuser\Desktop\CsharpProjects\TestProject>
在 Visual Studio Code 編輯器中更新
Console.WriteLine()
方法,如下所示:Console.WriteLine("Hello C#!");
第一次編輯 .cs 檔案時,Visual Studio Code 可能會提示您新增遺漏的資產,以建置應用程式並加以偵錯。 如果您看到此提示,則可以選取 [是]。
在 [檔案] 功能表上,選取 [儲存]。
您一律必須將程式碼變更儲存至檔案。 要等到程式碼儲存後,程式碼編譯器才有辦法辨識您在編輯器中所做的程式碼變更。
若要編譯應用程式的組建,請在終端的命令提示字元中輸入下列命令:
dotnet build
dotnet build
命令會將專案及其相依性建置成一組二進位檔。 二進位檔會在副檔名為 .dll 的中繼語言 (IL) 檔案中包含專案的程式碼。 視專案類型和設定而定,二進位檔中也可能會包含其他檔案。 如果您好奇,您可以在 EXPLORER 檢視中找到 TestProject.dll 檔案,其資料夾位置類似下列路徑:C:\Users\someuser\Desktop\CsharpProjects\TestProject\bin\Debug\net7.0\
注意
您的資料夾路徑會反映您的帳戶和 TestProject 資料夾的資料夾路徑。
若要執行應用程式,請在終端的命令提示字元中輸入下列命令:
dotnet run
dotnet run
命令會在沒有任何明確的編譯或啟動命令的情況下執行原始程式碼。 其提供了方便的選項,可讓您使用一個命令就從原始程式碼執行應用程式。 其適合從命令列進行的快速反覆式開發法。 此命令會依靠 dotnet build 命令來建置程式碼。請注意,Hello C# 會在 [終端] 面板中顯示於
dotnet run
命令下方那行。如果您看到畫面上顯示「Hello, World!」,請確定您已儲存程式碼變更。
恭喜,您已完成 Visual Studio Code 的設定,並已完成簡單程式碼的建置和執行!