文件范围命名空间声明怎么写
在 C# 10 中，
namespace可以直接跟一个分号结束，不用大括号包裹类型声明，这就是“文件范围命名空间”。它让整个 .cs 文件里的所有类型（类、记录、接口等）自动归属到该命名空间下。
常见错误是混用：比如写了文件范围
namespace X;，又在下面手动加了
namespace X { ... } 块——这会触发编译错误 CS8807（“无法在同一文件中混合使用文件范围和常规命名空间声明”）。 必须放在文件顶部，且只能有一个文件范围
namespace声明 所有类型定义（
class、
record、
struct等）必须紧跟其后，中间不能有空行或 using 指令（
using可以放在它前面，但不能穿插在 namespace 和类型之间） 不支持嵌套：不能写
namespace A.B;后再写
namespace A.C;—— 第二个会报错
和传统块式命名空间的区别在哪
传统写法需要把所有类型包进大括号里，缩进深、视觉噪音大；文件范围写法则扁平化，更接近 Go 或 Rust 的模块组织直觉。但要注意：它们语义完全等价，编译后生成的元数据没区别，只是语法糖。
性能无影响，但可读性取决于团队习惯。如果你的项目大量使用 partial 类或需跨多个命名空间组织类型，块式反而更清晰。
文件范围声明下，无法为不同类型指定不同子命名空间（例如不能让Program在
A，而
Helper在
A.Utils） 迁移时建议一次性改完单个文件，避免半块半文件范围混用导致 CS8807 IDE（如 VS 2022）对文件范围命名空间的支持已很成熟，但旧版 Resharper 可能提示“冗余命名空间”误报
能否和 global using 一起用
可以，而且推荐。C# 10 引入的
global using通常放在
Directory.Build.props或单独的
Usings.cs文件里，它与文件范围
namespace完全正交。
典型组合是：
global using System;+
global using static System.Console;放在头文件，然后业务文件用
namespace MyApp.Services;开头，清爽无冗余。
global using必须在任何
namespace声明之前（包括文件范围的） 如果某文件需要特殊 using（比如仅这个文件用
System.Text.Json），仍可在文件范围
namespace上方加普通
using注意别让
global using static引入过多扩展方法，可能污染 IntelliSense
升级到 C# 10 后为什么还是报错 CS8807
最常见原因是项目未真正启用 C# 10。即使装了 .NET 6 SDK，若
.csproj中没显式指定语言版本，MSBuild 默认按目标框架推断（例如面向 net6.0 时默认 C# 10，但某些旧模板或 CI 配置可能锁死在 C# 9）。
检查并修正
.csproj：
<PropertyGroup> <LangVersion>10.0</LangVersion> </PropertyGroup>VS 中右键项目 → “属性” → “生成” → “高级” → “语言版本” 下拉菜单选 “C# 10.0” 若用
<targetframework>net6.0</targetframework>，理论上无需额外设置，但 CI 环境可能缓存旧 SDK 版本 执行
dotnet --list-sdks确认安装的是 6.0.x 或更高版本 SDK
文件范围命名空间看着简单，但实际落地时，最容易被忽略的是构建环境一致性 —— 本地能编译，CI 失败，八成是 LangVersion 或 SDK 版本没对齐。
