共用方式為

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

  • 發行項

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

必要條件

建立 應用程式

建立名為 "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！」，然後結束。

The dotnet run command

增強應用程式

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

  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 鍵來回應提示。

    Terminal window with modified program output

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

其他資源

下一步

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

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

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

必要條件

建立 應用程式

建立名為 "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！」，然後結束。

The dotnet run command

增強應用程式

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

  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 鍵來回應提示。

    Terminal window with modified program output

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

其他資源

下一步

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

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

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

必要條件

建立 應用程式

建立名為 "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！」，然後結束。

The dotnet run command

增強應用程式

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

  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 鍵來回應提示。

    Terminal window with modified program output

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

其他資源

下一步

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

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