toplevel 语句必须放在项目中唯一一个 .cs 文件里，且该文件不能包含任何 namespace、class、struct 等顶层类型声明；编译器将整个文件视为 main 方法体处理。
TopLevel 语句必须放在哪个文件里
只能在项目中唯一一个 .cs 文件里写 TopLevel 语句，且该文件不能包含任何 namespace、class、struct 等顶层类型声明。编译器会把整个文件内容当作 Main 方法体来处理。
常见错误现象：CS8802 Only one compilation unit can have top-level statements —— 多个文件写了 TopLevel 语句；或者某个文件里写了 class Program { } 还同时写了裸代码。
- 新建控制台项目时，默认生成的
Program.cs就是为 TopLevel 设计的，删掉class Program和Main方法即可直接写逻辑 - 如果手动添加新
.cs文件并写 TopLevel 语句，必须确保原Program.cs已清空或改用显式Main - 不支持在
net5.0以下目标框架使用；最低要求<targetframework>net6.0</targetframework>
TopLevel 语句里能用 async/await 吗
可以，但必须配 await 的调用上下文 —— 编译器会自动把整个 TopLevel 文件包装成 async Task Main()，前提是至少有一个 await 表达式。
使用场景：快速写带 HTTP 请求、文件读取、延迟操作的脚本式程序。
- 写
await Task.Delay(1000);或await File.ReadAllTextAsync("a.txt");，编译器自动生成async Task Main - 只写
Console.WriteLine("hi");没await？那生成的是void Main，无法等待异步操作 - 别在 TopLevel 里写
Task.Run(...).Wait()—— 容易死锁，尤其在 Windows Forms/WPF 上下文里
TopLevel 语句访问命令行参数怎么写
用内置变量 args，类型是 string[]，和传统 static void Main(string[] args) 里的完全一样，无需声明。
参数差异：没有显式方法签名，所以不能重载 Main；所有参数入口统一走这个隐式 args。
if (args.Length == 0) { Console.WriteLine("missing arg"); return; }-
var input = args[0];直接用，不需要额外解析或声明 - 想用
System.CommandLine或Microsoft.Extensions.CommandLineUtils？照常new Parser(...).Invoke(args);，args就是现成的
为什么 TopLevel 语句里不能定义 public 类型
因为编译器要把整个文件“提升”为程序入口，它需要独占命名空间根作用域；一旦出现 public class X 或 public static void F()，就破坏了这个约定，触发 CS8803 Top-level statements must precede all other elements 错误。
容易踩的坑：复制粘贴旧代码时带进了 public static class Utils，或随手加了个 public const string Ver = "1.0";。
- 类型定义（
class/record/enum）必须挪到单独文件，或改成internal（仅限同一程序集内使用） - 局部函数可以写，比如
string FormatName(string s) => $"[{s}]";—— 它属于 TopLevel 语句块内部，合法 - 想共享逻辑？用
internal static class Helpers放另一个文件里，TopLevel 文件里直接调用Helpers.DoX()
最常被忽略的一点：TopLevel 不是语法糖，它改变了编译模型 —— 没有显式类，就没有 this、没有实例字段、不能继承，所有东西都得靠变量捕获或静态辅助类承载。
