文件范围命名空间是C# 10+正式语法，要求单文件单namespace X;（分号结尾），不可与块级namespace、顶级语句混用，不支持嵌套声明，且仅限.NET 6+。
文件范围命名空间不是“可选技巧”，而是 C# 10+ 的正式语法，用错位置或混用块级声明会直接编译失败。
namespace 后面不能跟花括号
这是最常踩的坑：把 namespace MyProject.Models; 写成 namespace MyProject.Models { } —— 后者是传统块级写法，前者才是文件范围声明。两者不能共存于同一文件。
- 文件中只要出现一个
namespace X;（分号结尾），整个文件就属于该命名空间，所有顶层类型自动归属其中 - 不能再有其他
namespace块，也不能再写另一个namespace Y; - 如果误写成
namespace X { class A { } }，又在下方加了namespace X;，编译器报错：CS8904: A file-scoped namespace cannot be nested in another namespace
不能和顶级语句（top-level statements）混用
Program.cs 里用了 Console.WriteLine 开头的写法？那这文件就不能声明文件范围命名空间。
- C# 要求：顶级语句必须出现在全局作用域，而
namespace X;会把后续所有内容包裹进命名空间作用域 - 一旦写了
namespace MyApp;，再写Console.WriteLine("hi");就会报错：CS0116: A namespace cannot directly contain members such as fields or methods - 解决办法只有两个：要么删掉
namespace声明，让文件保持全局作用域；要么把所有语句包进class Program { static void Main() { ... } }
using 指令的位置不影响命名空间作用域
using 可以放在 namespace X; 前、后、中间，都不改变类型归属——它们只影响当前文件内对类型的引用方式。
- 推荐统一放在文件顶部（
namespace声明之前），符合多数团队习惯 - 即使写成这样也合法：
using System; namespace MyApp; using System.Collections.Generic; <p>public class UserService { public List<string> GetNames() => new(); } - 但注意：
using static和别名（using Alias = ...）同样只作用于当前文件，不跨命名空间传播
嵌套命名空间无法用文件范围语法一步声明
想表达 MyCompany.Core.Utilities？不能写 namespace MyCompany.Core.Utilities; 然后在里面放 class PathHelper —— 这样 PathHelper 的完整名是 MyCompany.Core.Utilities.PathHelper，没错；但如果你还希望同文件里定义 MyCompany.Core.Services 下的类，就做不到。
- 文件范围命名空间只支持单一层级声明，不支持“部分嵌套”
- 要实现多级嵌套结构，只能回到块级写法：
namespace MyCompany.Core { namespace Utilities { ... } namespace Services { ... } } - 或者拆成多个文件，每个文件用各自的
namespace MyCompany.Core.Utilities;和namespace MyCompany.Core.Services;
真正容易被忽略的是兼容性边界：.NET 6+ 默认支持，但如果你项目 TargetFramework 是 net5.0 或更低，即使装了新 SDK，namespace X; 也会触发编译错误——它不是语法糖，而是语言版本强约束。
