1. 什么是全局和隐式using？

在 .NET 6 及更高版本中，Microsoft 引入了 全局 using 指令 和 隐式 using 指令，以简化代码结构并减少重复的 using 声明。

• o 全局 using 指令：允许在整个项目范围内定义 using，避免在每个文件顶部重复声明。
• o 隐式 using 指令：由 .NET SDK 自动生成常用的 using，无需手动添加。

这两个特性可以显著提高代码的可读性和开发效率。

2. 全局using指令

2.1 全局using的作用

全局 using 指令通过在 using 前添加 global 关键字，使得命名空间在整个项目中可用，无需在每个文件中重复声明。

2.2 如何使用全局using

1. 1. 创建一个全局 using 文件
   通常建议将全局 using 指令集中在一个文件中，文件名可以是 GlobalUsings.cs。
2. 2. 添加全局 using 指令
   在文件中添加需要全局使用的命名空间。例如：// filepath: GlobalUsings.cs
   global using System;
   global using System.Collections.Generic;
   global using System.Linq;
   global using Microsoft.AspNetCore.Mvc;
   global using Newtonsoft.Json;
3. 3. 项目范围生效
   一旦定义了全局 using，这些命名空间将在整个项目中自动可用，无需在每个文件顶部重复声明。

2.3 使用注意事项

• o 避免命名冲突：全局 using 会在整个项目范围内生效，可能导致命名冲突或意外的名称解析行为。
• o 选择性添加：仅将最常用且不易引发冲突的命名空间设置为全局。

3. 隐式using指令

3.1 隐式using的作用

隐式 using 是由 .NET SDK 自动生成的 using 指令，适用于常见的命名空间。它进一步减少了手动添加 using 的需求。

3.2 启用隐式using

隐式 using 默认在 .NET 6 及更高版本的模板项目中启用。如果需要手动启用，可以在项目文件（.csproj）中添加以下配置：

<!-- filepath: xxx.csproj -->
<PropertyGroup>
  <ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>

3.3 隐式using的默认命名空间

隐式 using 会根据项目类型（如控制台应用、Web 应用）自动添加一些常用命名空间。例如：

• o 控制台应用：using System;
  using System.Collections.Generic;
  using System.Linq;
  using System.Threading.Tasks;
• o ASP.NET Core 应用：using Microsoft.AspNetCore.Builder;
  using Microsoft.AspNetCore.Hosting;
  using Microsoft.Extensions.DependencyInjection;
  using Microsoft.Extensions.Hosting;

3.4 禁用隐式using

如果不需要隐式 using，可以在 .csproj 文件中将其禁用：

<PropertyGroup>
  <ImplicitUsings>disable</ImplicitUsings>
</PropertyGroup>

4. 全局和隐式using的对比

特性全局 using隐式 using定义方式手动添加 global using由 .NET SDK 自动生成作用范围整个项目根据项目类型自动适配灵活性高，可自定义低，依赖于 SDK 的默认配置适用场景常用命名空间，需全局可用常见的基础命名空间

5. 示例：结合使用全局和隐式using

以下是一个结合全局和隐式 using 的示例：

1. 1. 启用隐式 using
   在 .csproj 文件中启用隐式 using：<PropertyGroup>
   <ImplicitUsings>enable</ImplicitUsings>
   <TargetFramework>net9.0</TargetFramework>
   </PropertyGroup>
2. 2. 定义全局 using
   创建 GlobalUsings.cs 文件，添加全局命名空间：global using System.Text.Json;
   global using Microsoft.AspNetCore.Mvc;
   global using Swashbuckle.AspNetCore.Swagger;
3. 3. 使用全局和隐式 using
   在代码文件中直接使用这些命名空间，无需手动添加 using：public class WeatherForecastController : ControllerBase
   {
   [HttpGet]
   public IActionResult Get()
   {
   var json = JsonSerializer.Serialize(new { Message = "Hello, World!" });
   return Ok(json);
   }
   }

6. 常见问题与解决方案

问题 1：全局using导致命名冲突

解决方案：避免将可能与项目中其他命名空间冲突的命名空间设置为全局。

问题 2：隐式using添加了不需要的命名空间

解决方案：禁用隐式 using，并手动添加所需的命名空间。

问题 3：如何调试隐式using？

解决方案：查看项目的生成文件（如 obj/Debug/net0.0/<项目名>.GlobalUsings.g.cs），了解隐式添加的命名空间。

7. 总结

全局和隐式 using 是 .NET 6 引入的两个重要特性，旨在减少重复代码并提高开发效率。