<p>async Task Main 是唯一合法的异步入口签名，必须为 static async Task Main(string[] args) 或 static async Task<int> Main(string[] args)，且需启用 C# 7.1+ 语言版本；否则编译报 CS5001。</p>
async Task Main 是唯一合法的异步入口签名
别写 async void Main，它不会被识别为程序入口，编译直接报错；也别写 Task Main（没加 async），那只是个普通返回 Task 的同步方法，await 会失效。只有两种签名被运行时认可：
-
static async Task Main(string[] args)—— 程序等待所有await完成后干净退出 -
static async Task<int> Main(string[] args)</int>—— 可用return 1;向操作系统传递错误码
漏掉 async 或返回类型不是 Task / Task<int>，编译器就当它不存在，最终报 CS5001: Program does not contain a static 'Main' method suitable for an entry point。
必须显式启用 C# 7.1+ 语言版本
哪怕你用的是 .NET 8，只要项目没声明语言版本，async Task Main 就是无效语法。VS 默认可能仍用 C# 7.0 或更低——这不是 bug，是设计行为。
- 打开
.csproj文件，在任意<PropertyGroup>内加：<LangVersion>12</LangVersion>（推荐写具体数字，latest在某些 CI 环境下不可靠） - 或右键项目 → “属性” → “生成” → “高级” → “语言版本” → 选 “C# 12”
改完不重启 VS 有时也生效，但若仍报 CS5001，请先清理并重建项目。
HttpClient 不能在 Main 里 new 一次就扔
常见写法：var client = new HttpClient(); await client.GetStringAsync(...); —— 这在短期脚本里看似能跑，但有隐患：
-
HttpClient实例应复用，频繁创建会耗尽端口（TIME_WAIT） - 它不是线程安全的“临时对象”，并发调用
GetStringAsync可能出错 - 控制台程序生命周期短，容易忽略 Dispose，造成资源泄漏
简单方案：声明为 static readonly HttpClient；更稳妥方案：用 IServiceCollection + AddHttpClient（需引入 Microsoft.Extensions.DependencyInjection）。
别在 async Main 里用 Environment.Exit()
写 await DoWorkAsync(); Environment.Exit(1); 看似能提前退出，实际会跳过后续 await 和 finally 块，导致：
- 未完成的异步操作被强行中断（如文件写入一半、HTTP 请求未收尾）
- 未执行的
using或Dispose被跳过 - 父进程收到退出码，却不知道资源是否已释放
正确做法是让逻辑自然流到末尾，或用 return 1;（配合 Task<int> 签名）。如果真要中断流程，应设计可取消的 CancellationToken 并传给各 await 调用。
