2026-05-02 Web API，仍然可以自己定義 Main 方法

發表於 分類於 閱讀次數：
2026-05-02 Web API，仍然可以自己定義 Main 方法

2026-05-02 Web API，仍然可以自己定義 Main 方法

我:
Web API，仍然可以自己定義 Main 方法, 是寫在 program.cs 裡嗎? 如果在 program.cs 裡面寫 main 進入點, 則會與 ASP.NET Core Web API 的 main 相沖突嗎?

GPT:
這是個非常好的問題！在 ASP.NET Core Web API 的專案中，如果你選擇自己定義 Main 方法，確實是要寫在 Program.cs 裡面，但你不需要擔心與框架自動生成的 Main 方法發生衝突的問題。讓我來詳細說明為什麼這樣做是可行的，以及它的運作方式。

1. Program.cs 是應用程式的啟動點

在 ASP.NET Core 的 Web API 專案中，**Program.cs** 文件是應用程式的啟動點，也就是說 Main 方法應該寫在 Program.cs 中。在 ASP.NET Core 6 之前，Program.cs 文件中通常包含一個顯式的 Main 方法，用於啟動應用程式。

從 ASP.NET Core 6 開始，當引入了最小化 API 之後，Program.cs 中的頂層語句代替了顯式的 Main 方法，這讓代碼變得更簡潔。即便如此，如果你想手動撰寫一個完整的 Main 方法來定義應用程式的啟動邏輯，這樣做也是可行的。

2. 不會與框架的 Main 方法衝突

自己定義 Main 方法

如果你選擇自己在 Program.cs 中顯式定義一個 Main 方法，這段代碼就會被編譯器視為應用程式的唯一進入點。在這種情況下，編譯器不會再生成隱式的 Main 方法，因為你的 Main 方法將取代框架生成的默認邏輯。

例如，以下是顯式定義的 Main 方法：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

在這種情況下，編譯器會使用這個 Main 方法作為應用程式的進入點，因此不會出現與框架生成的 Main 方法相沖突的情況。

頂層語句和顯式 Main 方法的選擇

在使用 最小化 API（Minimal API） 時，你可以選擇使用頂層語句來簡化應用程式的代碼。如果你這樣做，編譯器會隱式地生成一個 Main 方法來包裹這些頂層語句，並將它作為應用的入口點。

但如果你明確在 Program.cs 中撰寫了一個 Main 方法，那麼頂層語句就不能再使用，因為一個應用程式中只能有一個入口點。如果存在顯式的 Main 方法，編譯器會忽略頂層語句，並使用你明確撰寫的 Main 方法。

3. 框架如何處理入口點

編譯器和框架遵循的規則是：

  • 一個應用程式只能有一個入口點：無論是顯式撰寫的 Main 方法，還是隱式生成的 Main 方法，兩者不可同時存在。
  • 優先級：如果你手動撰寫了 Main 方法，那麼這個方法會被認為是應用程式的入口點，編譯器不會再生成隱式的入口點。
  • 頂層語句的限制：頂層語句的方式只能用在你不打算顯式撰寫 Main 方法的情況下，這是為了簡化代碼，但當你需要更多控制時，你可以選擇手動定義入口點。

4. 什麼時候自己定義 Main 方法？

手動定義 Main 方法在以下情況下可能會更合適：

  • 需要更多控制的應用程式：如果你的應用程式需要對啟動過程進行更多自定義，例如對配置、環境變量、服務注入等進行精細控制，那麼顯式撰寫 Main 方法會給你更多的靈活性。
  • 需要傳統的 ASP.NET Core 啟動流程：一些企業應用或者大型應用希望保持對啟動流程的完全掌控，這樣便於維護和擴展，這時候手動定義 Main 方法也是一個好選擇。

小結

  1. 在 ASP.NET Core Web API 中，Main 方法可以手動定義在 Program.cs 文件中，這是應用程式的入口點。
  2. 如果你手動撰寫了 Main 方法，這個方法會成為唯一的入口點，編譯器不會再生成隱式的 Main 方法。因此，不會出現衝突的情況。
  3. 如果你使用頂層語句的方式（如最小化 API），那麼編譯器會隱式地生成 Main 方法。如果顯式撰寫 Main 方法，則頂層語句不再適用。

問題

問題：

  1. 如果你手動在 Program.cs 中撰寫了一個 Main 方法，這對應用程式的入口點有什麼影響？
  2. 在什麼情況下你會選擇使用顯式的 Main 方法而不是隱式的頂層語句？

希望這樣的解釋能幫助你理解 Main 方法在 ASP.NET Core Web API 中的角色。如果還有其他疑問或需要更深入的解釋，隨時告訴我！