教學課程：使用 Visual Studio Code 建立 .NET 主控台應用程式

本教學課程說明如何使用 Visual Studio Code 與 .NET CLI 建立及執行 .NET 主控台應用程式。 使用 .NET CLI 可以完成建立、編譯、執行專案等專案工作。 如有需要，您可以使用不同程式碼編輯器遵循本教學課程，並在終端機中執行命令。

必要條件

• 已安裝 C# 延伸模組的 Visual Studio Code (英文)。

  如果您已安裝 C# Dev Kit 延伸模組，請加以解除安裝或停用。 本教學課程系列不會加以使用。

  如需瞭解如何在 Visual Studio Code 上安裝延伸模組，請參閱 VS Code 延伸模組市集 (英文)。

• .NET 8 SDK。

建立 應用程式

建立名為 "HelloWorld" 的 .NET 主控台應用程式專案。

1. 啟動 Visual Studio Code。

2. 在主要功能表中依序點選 [檔案] > [開啟資料夾] (在 macOS 上請依序點選 [檔案] > [開啟...])。

3. 在 [開啟資料夾] 對話方塊中建立 [HelloWorld] 資料夾並加以選取。 接著按一下 [選取資料夾] (在 macOS 上請按一下 [開啟])。

   資料夾名稱會預設為專案名稱和命名空間名稱。 您稍後在教學課程中會新增程式碼，專案命名空間假設為 HelloWorld。

4. 在 [您是否信任此資料夾中檔案的作者?] 對話方塊中，選取 [是，我信任作者]。 您可以信任作者，因為此資料夾只有 .NET 產生的檔案，並由您新增或修改。

5. 在主要功能表內選取 [檢視]>[終端]，便能於 Visual Studio Code 中開啟 [終端]。

   終端會與命令提示字元一起在「HelloWorld」資料夾中開啟。

6. 在終端中輸入下列命令：

   dotnet new console --framework net8.0 --use-program-main
   

   開啟 Program.cs 檔案，以查看範本所建立的簡單應用程式：

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello, World!");
       }
   }
   

   第一次開啟「.cs」檔案時，Visual Studio Code 會提示您新增資產，以建置應用程式並加以偵錯。 選取 [是]，Visual Studio Code 便會建立含有 launch.json 與 tasks.json 檔案的 [.vscode] 資料夾。

   注意

   如果您沒有收到提示，或者尚未選取 [是] 就不小心關閉提示，請按照下列步驟建立 launch.json 與 tasks.json 檔案：

   • 在功能表中選取 [執行] > [新增設定]。
   • 在[選取環境] 提示中選取 .NET 5+ and .NET Core。

   此程式碼會定義 Program 類別，其中包含單一方法 Main，會將 String 陣列作為引數。 Main 是應用程式進入點，是執行階段在啟動應用程式時會自動呼叫的方法。 在應用程式啟動時所提供的所有命令列引數，都會在 args 陣列中提供。 Main 中的程式碼會呼叫 Console.WriteLine(String) 方法來在主控台視窗中顯示訊息。

   C# 具有名為最上層陳述式的功能，可讓您省略 Program 類別和 Main 方法。 本教學課程不會使用這項功能。 您可按風格偏好選擇是否在您的程式中使用。 在建立專案的 dotnet new 命令中，--use-program-main 選項會禁止使用最上層陳述式。

執行應用程式

在終端執行下列命令：

dotnet run

程式會顯示「Hello, World！」，然後結束。

增強應用程式

增強應用程式後，便可提示使用者輸入其名稱，並與日期和時間一併顯示。

1. 開啟 Program.cs。

2. 在 Program.cs 中以下列程式碼取代 Main 方法的內容 (即呼叫 Console.WriteLine 的那一行)：

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   此程式碼會在主控台視窗中顯示提示，然後等待使用者輸入字串並按下 Enter 鍵。 程式碼會將此字串儲存在名為 name 的變數中， 此程式碼也會擷取 DateTime.Now 屬性的值，其中包含目前的當地時間，並將它指派至名稱為 currentDate 的變數。 並在主控台視窗顯示這些值。 最後，程式碼會在主控台視窗中顯示提示，並呼叫 Console.ReadKey(Boolean) 方法，以等候使用者輸入。

   NewLine 是表示分行符號的方式，不受平台或語言影響。 與 C# 中的 \n 相同。

   字串前的貨幣符號 ($) 可讓您將變數名稱等運算式以大括號的方式放到字串中。 運算式的值會插入字串中，以取代運算式。 此語法稱為差補字串。

3. 儲存您的變更。

   重要

   在 Visual Studio Code 中，您必須明確儲存變更。 不同於 Visual Studio，當您建置和執行應用程式時，系統不會自動儲存檔案變更。

4. 再次執行程式：

   dotnet run
   

5. 輸入名稱並按 Enter 鍵來回應提示。

   

6. 按任意鍵以結束該程式。

其他資源

• 設定 Visual Studio Code

下一步

在本教學課程中，您已建立 .NET 控制台應用程式。 在下一個教學課程中，您會對應用程式進行偵錯。

使用 Visual Studio Code 對 .NET 主控台應用程式進行偵錯

本教學課程說明如何使用 Visual Studio Code 與 .NET CLI 建立及執行 .NET 主控台應用程式。 使用 .NET CLI 可以完成建立、編譯、執行專案等專案工作。 如有需要，您可以使用不同程式碼編輯器遵循本教學課程，並在終端機中執行命令。

必要條件

• 已安裝 C# 延伸模組的 Visual Studio Code (英文)。 如需瞭解如何在 Visual Studio Code 上安裝延伸模組，請參閱 VS Code 延伸模組市集 (英文)。
• .NET 7 SDK。

建立 應用程式

建立名為 "HelloWorld" 的 .NET 主控台應用程式專案。

1. 啟動 Visual Studio Code。

2. 在主要功能表中依序點選 [檔案] > [開啟資料夾] (在 macOS 上請依序點選 [檔案] > [開啟...])。

3. 在 [開啟資料夾] 對話方塊中建立 [HelloWorld] 資料夾並加以選取。 接著按一下 [選取資料夾] (在 macOS 上請按一下 [開啟])。

   資料夾名稱會預設為專案名稱和命名空間名稱。 您稍後在教學課程中會新增程式碼，專案命名空間假設為 HelloWorld。

4. 在 [您是否信任此資料夾中檔案的作者?] 對話方塊中，選取 [是，我信任作者]。 您可以信任作者，因為此資料夾只有 .NET 產生的檔案，並由您新增或修改。

5. 在主要功能表內選取 [檢視]>[終端]，便能於 Visual Studio Code 中開啟 [終端]。

   終端會與命令提示字元一起在「HelloWorld」資料夾中開啟。

6. 在終端中輸入下列命令：

   dotnet new console --framework net7.0
   

   這個專案範本會在「Program.cs」中呼叫 Console.WriteLine(String) 方法，藉此建立簡單的應用程式，在主控台視窗中顯示「Hello, World」。

   Console.WriteLine("Hello, World!");
   

7. 使用下列程式碼取代 Program.cs 的內容：

   namespace HelloWorld
   {
       class Program
       {
           static void Main(string[] args)
           {
               Console.WriteLine("Hello, World!");
           }
       }
   }
   

   第一次編輯「.cs」檔案時，Visual Studio Code 會提示您新增遺漏的資產，以建置應用程式並加以偵錯。 選取 [是]，Visual Studio Code 便會建立含有 launch.json 與 tasks.json 檔案的 [.vscode] 資料夾。

   注意

   如果您沒有收到提示，或者尚未選取 [是] 就不小心關閉提示，請按照下列步驟建立 launch.json 與 tasks.json 檔案：

   • 在功能表中選取 [執行] > [新增設定]。
   • 在[選取環境] 提示中選取 .NET 5+ and .NET Core。

   此程式碼會定義 Program 類別，其中包含單一方法 Main，會將 String 陣列作為引數。 Main 是應用程式進入點，是執行階段在啟動應用程式時會自動呼叫的方法。 在應用程式啟動時所提供的所有命令列引數，都會在 args 陣列中提供。

   最新版的 C# 提供名為最上層陳述式的新功能，可讓您省略 Program 類別與 Main 方法。 現有的 C# 程式大部分都不使用最上層陳述式，故本教學課程不會使用這項新功能。 但 C# 10 具備此功能，所以您可以根據自己的樣式偏好，決定是否要在程式中使用最上層陳述式。

執行應用程式

在終端執行下列命令：

dotnet run

程式會顯示「Hello, World！」，然後結束。

增強應用程式

增強應用程式後，便可提示使用者輸入其名稱，並與日期和時間一併顯示。

1. 開啟 Program.cs。

2. 在 Program.cs 中以下列程式碼取代 Main 方法的內容 (即呼叫 Console.WriteLine 的那一行)：

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   此程式碼會在主控台視窗中顯示提示，然後等待使用者輸入字串並按下 Enter 鍵。 程式碼會將此字串儲存在名為 name 的變數中， 此程式碼也會擷取 DateTime.Now 屬性的值，其中包含目前的當地時間，並將它指派至名稱為 currentDate 的變數。 並在主控台視窗顯示這些值。 最後，程式碼會在主控台視窗中顯示提示，並呼叫 Console.ReadKey(Boolean) 方法，以等候使用者輸入。

   NewLine 是表示分行符號的方式，不受平台或語言影響。 其他表示方式還有 C# 中的 \n 和 Visual Basic 中的 vbCrLf。

   字串前的貨幣符號 ($) 可讓您將變數名稱等運算式以大括號的方式放到字串中。 運算式的值會插入字串中，以取代運算式。 此語法稱為差補字串。

3. 儲存您的變更。

   重要

   在 Visual Studio Code 中，您必須明確儲存變更。 不同於 Visual Studio，當您建置和執行應用程式時，系統不會自動儲存檔案變更。

4. 再次執行程式：

   dotnet run
   

5. 輸入名稱並按 Enter 鍵來回應提示。

   

6. 按任意鍵以結束該程式。

其他資源

• 設定 Visual Studio Code

下一步

在本教學課程中，您已建立 .NET 控制台應用程式。 在下一個教學課程中，您會對應用程式進行偵錯。

使用 Visual Studio Code 對 .NET 主控台應用程式進行偵錯

本教學課程說明如何使用 Visual Studio Code 與 .NET CLI 建立及執行 .NET 主控台應用程式。 使用 .NET CLI 可以完成建立、編譯、執行專案等專案工作。 如有需要，您可以使用不同程式碼編輯器遵循本教學課程，並在終端機中執行命令。

必要條件

• 已安裝 C# 延伸模組的 Visual Studio Code (英文)。 如需瞭解如何在 Visual Studio Code 上安裝延伸模組，請參閱 VS Code 延伸模組市集 (英文)。
• .NET 6 SDK。

建立 應用程式

建立名為 "HelloWorld" 的 .NET 主控台應用程式專案。

1. 啟動 Visual Studio Code。

2. 在主要功能表中依序點選 [檔案] > [開啟資料夾] (在 macOS 上請依序點選 [檔案] > [開啟...])。

3. 在 [開啟資料夾] 對話方塊中建立 [HelloWorld] 資料夾並加以選取。 接著按一下 [選取資料夾] (在 macOS 上請按一下 [開啟])。

   資料夾名稱會預設為專案名稱和命名空間名稱。 您稍後在教學課程中會新增程式碼，專案命名空間假設為 HelloWorld。

4. 在 [您是否信任此資料夾中檔案的作者?] 對話方塊中，選取 [是，我信任作者]。 您可以信任作者，因為此資料夾只有 .NET 產生的檔案，並由您新增或修改。

5. 在主要功能表內選取 [檢視]>[終端]，便能於 Visual Studio Code 中開啟 [終端]。

   終端會與命令提示字元一起在「HelloWorld」資料夾中開啟。

6. 在終端中輸入下列命令：

   dotnet new console --framework net6.0 --use-program-main
   

   這個專案範本會在「Program.cs」中呼叫 Console.WriteLine(String) 方法，藉此建立簡單的應用程式，在主控台視窗中顯示「Hello, World」。

   namespace HelloWorld;
   
   class Program
   {
       static void Main(string[] args)
       {
           Console.WriteLine("Hello, World!");
       }
   }
   

   第一次編輯「.cs」檔案時，Visual Studio Code 會提示您新增遺漏的資產，以建置應用程式並加以偵錯。 選取 [是]，Visual Studio Code 便會建立含有 launch.json 與 tasks.json 檔案的 [.vscode] 資料夾。

   注意

   如果您沒有收到提示，或者尚未選取 [是] 就不小心關閉提示，請按照下列步驟建立 launch.json 與 tasks.json 檔案：

   • 在功能表中選取 [執行] > [新增設定]。
   • 在[選取環境] 提示中選取 .NET 5+ and .NET Core。

   此程式碼會定義 Program 類別，其中包含單一方法 Main，會將 String 陣列作為引數。 Main 是應用程式進入點，是執行階段在啟動應用程式時會自動呼叫的方法。 在應用程式啟動時所提供的所有命令列引數，都會在 args 陣列中提供。

   最新版的 C# 提供名為最上層陳述式的新功能，可讓您省略 Program 類別與 Main 方法。 現有的 C# 程式大部分都不使用最上層陳述式，故本教學課程不會使用這項新功能。 但 C# 10 具備此功能，所以您可以根據自己的樣式偏好，決定是否要在程式中使用最上層陳述式。 在用於建立專案的 dotnet new 命令中，--use-program-main 選項會禁止使用最上層陳述式。

執行應用程式

在終端執行下列命令：

dotnet run

程式會顯示「Hello, World！」，然後結束。

增強應用程式

增強應用程式後，便可提示使用者輸入其名稱，並與日期和時間一併顯示。

1. 開啟 Program.cs。

2. 在 Program.cs 中以下列程式碼取代 Main 方法的內容 (即呼叫 Console.WriteLine 的那一行)：

   Console.WriteLine("What is your name?");
   var name = Console.ReadLine();
   var currentDate = DateTime.Now;
   Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!");
   Console.Write($"{Environment.NewLine}Press any key to exit...");
   Console.ReadKey(true);
   

   此程式碼會在主控台視窗中顯示提示，然後等待使用者輸入字串並按下 Enter 鍵。 程式碼會將此字串儲存在名為 name 的變數中， 此程式碼也會擷取 DateTime.Now 屬性的值，其中包含目前的當地時間，並將它指派至名稱為 currentDate 的變數。 並在主控台視窗顯示這些值。 最後，程式碼會在主控台視窗中顯示提示，並呼叫 Console.ReadKey(Boolean) 方法，以等候使用者輸入。

   NewLine 是表示分行符號的方式，不受平台或語言影響。 其他表示方式還有 C# 中的 \n 和 Visual Basic 中的 vbCrLf。

   字串前的貨幣符號 ($) 可讓您將變數名稱等運算式以大括號的方式放到字串中。 運算式的值會插入字串中，以取代運算式。 此語法稱為差補字串。

3. 儲存您的變更。

   重要

   在 Visual Studio Code 中，您必須明確儲存變更。 不同於 Visual Studio，當您建置和執行應用程式時，系統不會自動儲存檔案變更。

4. 再次執行程式：

   dotnet run
   

5. 輸入名稱並按 Enter 鍵來回應提示。

   

6. 按任意鍵以結束該程式。

其他資源

• 設定 Visual Studio Code

下一步

在本教學課程中，您已建立 .NET 控制台應用程式。 在下一個教學課程中，您會對應用程式進行偵錯。

使用 Visual Studio Code 對 .NET 主控台應用程式進行偵錯