<p>文件范围命名空间是C# 10+正式语法，必须写为namespace X;（分号不可省略），不能与花括号块式混用，且不可与顶级语句共存于同一文件。</p>
文件范围命名空间不是“写得更短一点”的可选技巧，而是 C# 10+（.NET 6+）的正式语法，用错位置或混用传统写法会直接编译失败。
namespace 后面必须跟分号，不能跟花括号
这是最常触发 CS8904 或 CS1514 错误的地方：把 namespace MyProject.Models { } 当成文件范围写法。实际正确的只有 namespace MyProject.Models; —— 分号是语法必需，不是风格选择。
- 写了花括号就是传统块级命名空间，和文件范围互斥
- 哪怕只多打一个空格或换行在分号前，比如
namespace MyProject.Models ;，部分旧版 SDK 仍可能报错 - Visual Studio 2022 17.0+ 和 Rider 2023.3+ 能高亮提示分号缺失，但编译器不会自动补全
不能和顶级语句（top-level statements）共存于同一文件
如果 Program.cs 以 Console.WriteLine 开头，那这文件就属于全局作用域；一旦加了 namespace MyApp;，后续所有语句都会被拉进命名空间作用域，导致 CS0116：“命名空间不能直接包含字段或方法”。
- 错误示例：
namespace MyApp; Console.WriteLine("hi");→ 编译失败 - 正确做法二选一：删掉
namespace声明，或把语句包进class Program { static void Main() { } } - ASP.NET Core Minimal Hosting 模式默认启用顶级语句，新建项目时需注意模板是否已含
namespace
using 指令的位置影响作用域范围
using 放在 namespace X; 前后，语义不同：前者作用于全局，后者仅限该命名空间内生效。
- 推荐统一放在文件顶部（
namespace声明之前），避免意外限定 - 不推荐写法：
namespace MyApp; using System.Text; class A { public string ToJson() => JsonSerializer.Serialize(this); }→ 此处JsonSerializer未导入System.Text.Json，会报错 -
global using不受此限制，它始终全局有效，但和文件范围命名空间无绑定关系
嵌套命名空间能写，但无法在一个文件里声明多个逻辑层级
namespace MyCompany.Core.Utilities; 是合法的，class PathHelper 的完整类型名确实是 MyCompany.Core.Utilities.PathHelper。但你不能靠它“拆分”嵌套结构。
- 想在同一文件定义
MyCompany.Core.Services.UserService？做不到——文件范围只允许一个namespace声明 - 若真需要多层级类型，要么用传统块式写法（
namespace MyCompany.Core { namespace Services { ... } }），要么拆成多个文件 - Protobuf 或 gRPC 生成代码通常依赖块式结构，手动改成文件范围写法后，下次 regen 会被覆盖
最容易被忽略的是环境前提：必须确认项目 SDK 版本 ≥ net6.0，且 CSharpVersion 未被显式降级（如 <LangVersion>9.0</LangVersion> 会彻底禁用该语法）。
