C# 文件级 using（global using）

项目文件顶上堆了十几行 using，每个文件都要重复写一遍。C# 10 引入的文件级 using 指令（global using） 就是为了解决这个痛点------允许在文件顶部用 global 关键字声明全局 using，使该命名空间在整个项目中所有文件都可用，无需重复声明。

何时使用全局 using：项目公共命名空间、工具类、大型项目统一管理
基本用法：传统 vs 全局 using 的对比
常用与高级操作：隐式启用、条件编译、静态 using、别名

一、使用场景

项目中频繁使用的命名空间 ：如 System、System.Collections.Generic
公共工具类和扩展方法所在的命名空间
减少代码重复：避免每个文件头部重复声明
大型项目中的统一命名空间管理 ：集中维护 GlobalUsings.cs

二、注意事项

作用域优先级：文件级 using 优先级高于全局 using
命名冲突：多个全局 using 可能导致同名类型冲突
编译顺序：全局 using 必须在任何类型声明之前
项目兼容性 ：需要 C# 10.0 或更高版本（.NET 6+）

常见坑： 滥用全局 using 会导致隐式依赖 ，新团队成员难以快速看出当前文件实际引用了哪些命名空间。建议仅在项目级公共命名空间使用，避免将所有 using 都"global"化。

三、基本用法

3.1 传统 using（文件作用域）

csharp 复制代码

using System;
using System.Collections.Generic;

namespace MyProject
{
    public class MyClass
    {
        // 类实现
    }
}

3.2 文件级 using（全局作用域）

csharp 复制代码

// 在 GlobalUsings.cs 或任何文件中
global using System;
global using System.Collections.Generic;

namespace MyProject
{
    public class MyClass
    {
        // 可以直接使用 List<> 而无需额外 using
    }
}

四、常用操作

1. 创建全局 using 文件

csharp 复制代码

// GlobalUsings.cs
global using System;
global using System.Linq;
global using Microsoft.Extensions.Logging;

2. 隐式全局 using（.NET 6+）

在项目文件中启用：

xml 复制代码

<PropertyGroup>
  <ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>

效果：SDK 将自动生成一组常用命名空间的 global using（如 System、System.Linq 等）。

3. 条件全局 using

csharp 复制代码

#if NET6_0_OR_GREATER
global using System.Text.Json;
#else
global using Newtonsoft.Json;
#endif

代码解析：

#if ... #else ... #endif：根据目标框架编译不同的全局 using，实现跨版本兼容。

五、高级用法

1. 静态全局 using

csharp 复制代码

global using static System.Math;
global using static System.Console;

// 直接使用
double result = Sin(PI / 2);
WriteLine(result);

优势：避免每处写 Math.Sin、Console.WriteLine，提升简洁度。注意：过度使用会降低代码可读性，建议仅在数学计算密集型代码中使用。

2. 别名全局 using

csharp 复制代码

global using Json = System.Text.Json.JsonSerializer;
global using List = System.Collections.Generic.List<int>;

// 使用别名
var data = Json.Serialize(new List { 1, 2, 3 });

常见坑： 别名与现有类型名冲突（如 List 可能让读者误以为是泛型）。建议只在非常简短且上下文清晰时使用别名。

3. 项目级统一管理（非必需）

csharp 复制代码

// 在共享项目中定义
public static class GlobalUsings
{
    // 空类，仅用于组织全局 using
}

（实际项目中更推荐直接用 GlobalUsings.cs 文件，无需包装类。）

最后： 全局 using 是提升开发体验的好工具，但不要为了"少写几行"而牺牲代码的显式性。在团队项目中，建议建立"全局 using 清单"并文档化，让每个成员都清楚项目隐式依赖了哪些命名空间。

‍