C#globalusing全局引入的使用

C# 10 带来的 global using 指令，说白了就是帮我们简化代码，减少那些重复的 using 声明。以前每个文件都得写一遍，现在可以在项目级别定义一个全局生效的 using 语句，所有代码文件都能共用，省事不少。

1. 什么是global using？

global using 是 C# 10 新增的一个特性，用法很简单：在 using 关键字前面加上 global，这个命名空间就能在整个项目中全局生效。换句话说，项目里任何一个代码文件都能自动引用它，不需要再手动加 using 指令了。

举个例子：

// 在任意 .cs 文件中使用
global using System.Text.Json;

声明完之后，项目里所有文件都能直接用 JsonSerializer 这些类型，再也不用每处都写 using System.Text.Json; 了。

2. 如何使用global using？

基本用法

• 语法很简单：global using <命名空间>;
• 必须放在代码文件的顶部，不能放在 namespace 声明里面。
• 可以出现在任何 .cs 文件里，不过更推荐统一管理。

推荐实践：使用GlobalUsings.cs文件

最佳做法是，在项目里创建一个叫 GlobalUsings.cs 的专用文件，把所有的全局 using 集中放在一起。这算是社区和微软目前最推荐的做法。

示例：

// GlobalUsings.cs
global using System;
global using System.Collections.Generic;
global using System.Linq;
global using System.Threading.Tasks;
global using Microsoft.EntityFrameworkCore;

默认的全局引用

如果你创建的是 .NET 6+ 的新项目（比如控制台程序、Web API 等），SDK 会隐式生成一些常用命名空间的全局引用。这个设置体现在项目文件里的 ImplicitUsings 配置：

    enable

开启之后，像下面这些命名空间就会自动全局可用（以控制台程序为例）：

• System
• System.Collections.Generic
• System.IO
• System.Linq
• System.Net.Http
• System.Threading
• System.Threading.Tasks

3. global using的注意事项

不能放在namespace内部

namespace MyApp
{
    global using System; // ❌ 编译错误
}

这一点要特别留意，语法上就禁止这么写。

条件编译支持

global using 也能和条件编译结合，比如只在 Debug 模式下才引用某个命名空间：

#if DEBUG
global using System.Diagnostics;
#endif

显式与隐式的关系

• 隐式全局引用（由 SDK 自动生成的）可以手动删除。
• 显式全局引用（你自己写的 global using）也可以通过再次声明来隐藏或覆盖。

多个文件中使用

global using 可以在多个文件里声明，但同一个命名空间如果出现两次，编译器会报 CS8801 警告。所以最好确保每个命名空间只声明一次。

4. 常见场景

5. 总结

global using 带来的好处挺明显的：

• 减少重复代码，开发效率能提上来
• 统一管理项目引用，维护起来也更省心
• 如果和新项目模板的 ImplicitUsings 配合使用，效果会更理想

怎么用比较合理：

• 那些基础、稳定而且项目全局都需要用的命名空间（比如 System、System.Linq 这些），非常适合做成 global using。
• 但如果是某个模块特有的命名空间，还是建议用传统的 using，这样可以让模块之间的独立性更清晰。