顶级语句是编译器自动生成隐式Program类和Main方法的机制，仅适用于单入口控制台或简单工具项目；它要求项目SDK为Microsoft.NET.Sdk、目标框架≥net5.0、LangVersion≥10，且一个项目只能有一个顶级语句入口文件。
顶级语句（Top-level statements）不是语法糖，而是编译器在背后帮你生成了隐式的 Program 类和 Main 方法——所以它只适用于单入口的控制台/简单工具项目，不能直接用于类库、ASP.NET Core 项目（除非用 .NET 6+ 的 Minimal Hosting 模式），也不支持多 Main 入口。
什么时候能直接写代码而不用 class Program？
只要项目 SDK 是 net5.0 或更高（推荐 net6.0 及以上），同时 10，C# 编译器就会启用顶级语句模式。
- 新建项目时用
dotnet new console（.NET 6+ 默认启用）会直接生成一个只有Console.WriteLine("Hello, World!");的Program.cs - 如果已有传统项目，删掉
class Program { static void Main() { ... } }，把方法体里的代码提到文件顶层即可 - 多个
.cs文件里可以各写顶级语句，但最终只能有一个入口点；编译器按文件名顺序（非字典序）合并执行逻辑，实际行为不保证，**不要依赖多文件顶级语句的执行顺序**
args 怎么拿到？能访问 Environment 吗？
可以。顶级语句上下文天然拥有对 args 参数的访问权，也完全能调用 Environment.GetCommandLineArgs()、Console、File 等所有常规 API。
Console.WriteLine($"共 {args.Length} 个参数");
foreach (var arg in args)
{
Console.WriteLine($" → {arg}");
}
if (args.Length > 0 && args[0] == "--help")
{
Console.WriteLine("用法：dotnet run [--help]");
}
-
args类型是string[]，和传统Main(string[] args)一致 - 不能在顶级语句中声明另一个同名的
args变量（会编译错误：The name 'args' is declared in an enclosing scope） - 想提前退出？直接写
return;或Environment.Exit(1);都有效
为什么加了 using static System.Console 还报错说 WriteLine 找不到？
因为顶级语句的“作用域”比你想象得更靠前：所有 using 指令必须出现在文件最顶部，且必须在任何可执行语句之前。一旦中间夹了空行、注释或任意表达式，后续的 using static 就不再对顶级语句生效。
- ✅ 正确写法：
using static System.Console;
using System.IO;
<p>WriteLine("OK"); // 能用
WriteLine(Path.GetTempPath());</p>
- ❌ 错误写法（以下任一都会导致
WriteLine不识别）：
using static System.Console;
<p>// 这里空一行就断开了作用域链</p><p>WriteLine("error"); // 编译失败：CS0103 名称“WriteLine”不存在于当前上下文中</p>
- 注意：
using static仅影响顶级语句部分，不影响后续定义的类/方法内部 - 如果用了
global using（如GlobalUsings.cs），则不受此限制，但需确认项目启用了enable
真正容易被忽略的是：顶级语句不等于“无结构”。它只是隐藏了类和方法壳子，但变量作用域、异步支持（await）、局部函数、try/catch 都照常工作——只是你不能再写 public static void Main 了，也不能在一个文件里混用顶级语句和显式 Main 方法，否则编译器会报 CS8802（单个项目只能有一个入口点）。
