编辑“︁C Sharp 命名空间”︁

= C#命名空间 =

== 介绍 ==
'''命名空间'''（Namespace）是C#中用于组织代码的逻辑容器，它通过避免命名冲突和提供层次化结构来管理大型代码库。命名空间可以包含类、接口、结构、枚举、委托和其他命名空间，是.NET框架中代码组织的核心机制之一。

命名空间的主要作用包括：
* '''避免命名冲突'''：不同库或团队开发的代码可能使用相同的类名，命名空间确保这些类可以通过不同的命名空间区分。
* '''代码组织'''：将相关功能分组，提高代码的可读性和可维护性。
* '''访问控制'''：通过<code>using</code>指令简化对命名空间成员的访问。

== 基本语法 ==
命名空间通过<code>namespace</code>关键字定义，语法如下：
<syntaxhighlight lang="csharp">
namespace NamespaceName
{
    // 类、接口、结构等定义
}
</syntaxhighlight>

=== 示例：定义和使用命名空间 ===
以下代码定义了一个命名空间<code>MyApplication</code>，其中包含一个类<code>HelloWorld</code>：
<syntaxhighlight lang="csharp">
namespace MyApplication
{
    public class HelloWorld
    {
        public void SayHello()
        {
            Console.WriteLine("Hello, World!");
        }
    }
}
</syntaxhighlight>

在另一个文件中使用该命名空间：
<syntaxhighlight lang="csharp">
using MyApplication;

class Program
{
    static void Main()
    {
        HelloWorld hello = new HelloWorld();
        hello.SayHello(); // 输出: Hello, World!
    }
}
</syntaxhighlight>

== 嵌套命名空间 ==
命名空间可以嵌套，形成层次化结构：
<syntaxhighlight lang="csharp">
namespace OuterNamespace
{
    namespace InnerNamespace
    {
        public class NestedClass
        {
            public void Display()
            {
                Console.WriteLine("Nested class inside InnerNamespace");
            }
        }
    }
}
</syntaxhighlight>

或者使用点语法简化嵌套定义：
<syntaxhighlight lang="csharp">
namespace OuterNamespace.InnerNamespace
{
    public class NestedClass
    {
        public void Display()
        {
            Console.WriteLine("Nested class inside InnerNamespace");
        }
    }
}
</syntaxhighlight>

调用嵌套命名空间中的类：
<syntaxhighlight lang="csharp">
using OuterNamespace.InnerNamespace;

class Program
{
    static void Main()
    {
        NestedClass nested = new NestedClass();
        nested.Display(); // 输出: Nested class inside InnerNamespace
    }
}
</syntaxhighlight>

== 全局命名空间 ==
未显式声明命名空间的代码属于'''全局命名空间'''（Global Namespace）。全局命名空间的成员可以直接访问，但容易引发命名冲突：
<syntaxhighlight lang="csharp">
// 全局命名空间
class GlobalClass
{
    public void Show() => Console.WriteLine("Global class");
}
</syntaxhighlight>

== <code>using</code>指令 ==
<code>using</code>指令用于简化命名空间成员的访问：
* '''using 命名空间'''：引入整个命名空间。
* '''using static'''（C# 6+）：引入特定类的静态成员。
* '''using 别名'''：为命名空间或类型创建简短别名。

=== 示例：using static ===
<syntaxhighlight lang="csharp">
using static System.Console;

class Program
{
    static void Main()
    {
        WriteLine("直接调用Console.WriteLine"); // 无需写Console前缀
    }
}
</syntaxhighlight>

=== 示例：using 别名 ===
<syntaxhighlight lang="csharp">
using MyAlias = MyApplication.HelloWorld;

class Program
{
    static void Main()
    {
        MyAlias hello = new MyAlias();
        hello.SayHello();
    }
}
</syntaxhighlight>

== 实际应用案例 ==
=== 案例1：避免第三方库冲突 ===
假设项目同时使用两个库，均包含<code>Logger</code>类：
<syntaxhighlight lang="csharp">
namespace LibraryA
{
    public class Logger { /* 实现A */ }
}

namespace LibraryB
{
    public class Logger { /* 实现B */ }
}

// 使用时明确指定命名空间
var loggerA = new LibraryA.Logger();
var loggerB = new LibraryB.Logger();
</syntaxhighlight>

=== 案例2：模块化项目结构 ===
大型项目通常按功能划分命名空间：
<mermaid>
graph TD
    A[MyApp] --> B[DataAccess]
    A --> C[BusinessLogic]
    A --> D[UI]
    B --> E[Repositories]
    B --> F[Models]
</mermaid>

对应代码结构：
<syntaxhighlight lang="csharp">
namespace MyApp.DataAccess.Repositories
{
    public class UserRepository { /* ... */ }
}

namespace MyApp.BusinessLogic.Services
{
    public class UserService { /* ... */ }
}
</syntaxhighlight>

== 常见问题 ==
=== 1. 何时应该创建新命名空间？ ===
* 当功能模块具有明确边界时（如数据访问层、业务逻辑层）。
* 当代码量增长导致单个文件难以维护时。
* 当需要与外部库集成且可能发生命名冲突时。

=== 2. 命名空间命名规范 ===
* 使用公司/组织名称作为根命名空间（如<code>Microsoft</code>、<code>Google</code>）。
* 遵循帕斯卡命名法（PascalCase）。
* 避免与系统命名空间冲突（如不要使用<code>System</code>作为自定义命名空间）。

== 高级主题 ==
=== 命名空间与程序集的关系 ===
命名空间是逻辑分组，而'''程序集'''（.dll或.exe文件）是物理分组。一个程序集可以包含多个命名空间，一个命名空间也可以跨多个程序集。

=== 使用<code>global::</code>别名 ===
解决嵌套命名空间冲突：
<syntaxhighlight lang="csharp">
namespace MyApp
{
    namespace System
    {
        class MyClass
        {
            // 强制使用全局System命名空间
            global::System.Console.WriteLine("Avoid conflict");
        }
    }
}
</syntaxhighlight>

== 总结 ==
命名空间是C#代码组织的基石，通过合理使用可以：
* 提高代码可读性和可维护性
* 有效避免命名冲突
* 支持大型项目的模块化开发

掌握命名空间的使用是成为高效C#开发者的关键一步。

[[Category:编程语言]]
[[Category:C Sharp]]
[[Category:C Sharp 基础]]