file修饰符是独立访问修饰符，只能用于顶层类型声明开头，不可与public/private等混用；它限制类型仅在当前源文件内可见，跨文件引用会报cs0246错误。
file修饰符只能用在类型声明开头，不能和public/private混用
你写 public file class Helper 会直接编译失败——file 是独立访问修饰符，不是补充说明。它替代了 public、internal、private 的位置，语法上互斥。
常见错误现象：VS 提示 “CS0106: 修饰符 ‘file’ 对于此项无效” 或 “CS8904: 无法将 ‘file’ 与其他访问修饰符结合使用”。
-
file class FileScopedLogger✅ 正确 -
internal file interface IHelper❌ 编译报错 -
file record struct Point(int X, int Y)✅ 支持 record/struct/interface/enum
跨文件引用file类型时，编译器报错信息很明确
如果另一个 .cs 文件里写了 var x = new FileScopedLogger();，编译器不会静默忽略，而是抛出 CS0246: 未能找到类型或命名空间名“FileScopedLogger” —— 注意，它不提示“不可访问”，而是彻底“找不到”，因为该类型在语义分析阶段就未被导入到其他文件的作用域中。
这意味着：
- 即使两个文件在同一命名空间、同一程序集，也无法互相看见
file类型 - IntelliSense 不会补全，.NET SDK 构建时直接失败，不进运行时
- 反射（
Assembly.GetTypes()）也查不到这些类型，它们不参与元数据导出
file类型可以被同文件的public成员间接暴露
你不能从外部 new 一个 file 类，但可以把它藏在 public 方法返回值里，只要调用方只依赖公开契约，不关心具体类型。
比如：
file class FileScopedConfig { public string ApiUrl => "https://api.example.com"; }
public static class ConfigFactory {
public static object GetConfig() => new FileScopedConfig(); // 返回 object 或接口
}
这样外部能用，但无法向下转型或直接构造——这是有意为之的封装边界。
- 适合隐藏生成器产出的辅助类、临时重构用的过渡类型
- 若想彻底禁止外部感知，别让它出现在 public 签名中（包括返回值、参数、属性类型）
- 扩展方法（
static class Extensions）必须和file类型在同一个文件，否则无法定义
file类型不解决命名冲突的全部场景，小心 NuGet 包或生成代码反向引用
虽然 file 让你在本项目内放心重用类名（比如多个 file class Mapper 分散在不同 .cs 文件），但它对第三方库无影响。如果某个 NuGet 包的 API 恰好期望接收一个叫 Mapper 的类型，而你本地也定义了 file class Mapper，那二者依然不兼容——因为外部包根本看不到你的 file 类。
更隐蔽的问题是源生成器（Source Generator）：如果生成器输出的代码试图引用你写的 file 类型，会失败，除非生成器本身也运行在同文件上下文（极少见）。所以实际用在生成代码场景时，优先考虑 internal + 命名空间隔离，而非盲目上 file。
