【转】[C#] GlobalUsing 的使用

转自：豆包ai

在 C# 10 及以上版本中，Global Using 指令（全局 using 指令）是一项简化代码的新特性，允许在项目级别定义全局生效的 using 语句，无需在每个代码文件中重复声明。这能显著减少重复代码，使文件更简洁。

核心作用

传统上，每个 .cs 文件如需使用某个命名空间（如 System、System.Collections.Generic），都需要在文件顶部添加 using 指令。而 Global Using 允许在单个文件中声明一次，让该命名空间在整个项目的所有代码文件中生效。

使用方式

1. 关键字 global 修饰 using 指令

在任意 .cs 文件中（通常建议单独创建一个 GlobalUsings.cs 集中管理），用 global 关键字修饰 using 语句：

csharp

 

 

// GlobalUsings.cs（文件名可自定义）
global using System;
global using System.Collections.Generic;
global using System.Linq;
global using Microsoft.AspNetCore.Mvc;

 

之后，项目中所有 .cs 文件无需再写 using System; 等，可直接使用这些命名空间下的类型（如 List<T>、ControllerBase）。

2. 隐式全局 Using（针对项目模板）

某些项目模板（如 ASP.NET Core Web API、Console App）会自动生成隐式的全局 using，无需手动声明。例如：

• ASP.NET Core 项目默认包含 global using Microsoft.AspNetCore.Builder;、global using Microsoft.AspNetCore.Http; 等，简化 Web 开发常用命名空间。
• 这些隐式全局 using 由项目文件（.csproj）中的 <ImplicitUsings>enable</ImplicitUsings> 控制（默认启用）。

注意事项

1. 作用范围：仅对当前项目有效，不影响引用的其他项目或类库。
2. 文件位置：全局 using 可写在任意 .cs 文件中，但建议集中放在 GlobalUsings.cs 中，便于维护。
3. 与普通 using 的关系：全局 using 不会替代文件内的 using，文件内的 using 仍可补充或覆盖全局设置（如 using static 或别名）。
4. 禁用隐式全局 Using：若不需要模板自动生成的全局 using，可在 .csproj 中关闭：
   xml

    

    

   <Project Sdk="Microsoft.NET.Sdk.Web"><PropertyGroup><TargetFramework>net8.0</TargetFramework><ImplicitUsings>disable</ImplicitUsings> <!-- 关闭隐式全局 using --></PropertyGroup>
   </Project>
   

    
    
5. 命名冲突：若全局 using 的命名空间存在类型冲突，仍需在文件内通过显式命名空间（如 System.Text.Json.JsonSerializer）或 using 别名解决。

优势

• 减少重复代码：避免在每个文件顶部重复声明常用命名空间（如 System、System.Linq）。
• 统一管理：集中维护项目级别的命名空间引用，便于团队规范。
• 简化新人上手成本：无需记忆或手动添加大量基础 using 指令。

适用场景

• 项目中频繁使用的命名空间（如 System、System.Collections.Generic）。
• 框架 / 库特有的常用命名空间（如 ASP.NET Core 的 Microsoft.AspNetCore.Mvc、Entity Framework Core 的 Microsoft.EntityFrameworkCore）。

总结：Global Using 是 C# 10+ 中提升开发效率的实用特性，通过全局声明减少重复代码，尤其适合中大型项目或框架开发场景。