您现在的位置：程式碼之家 >> 編程語言 > >> .NET 網頁程式設計 >> C# >> C# 入門

C# 命名空間完整指南：組織代碼、避免衝突與最佳實踐

編輯：C# 入門

C# 命名空間完整指南：組織代碼、避免衝突與最佳實踐

在大型專案開發中，類別名稱衝突是常見的頭痛問題。C# 的命名空間機制正是為了解決這一問題而設計的核心功能——它提供了一種邏輯分組方式，讓相同名稱的類別能夠共存於不同的命名空間中而不產生衝突。本文將深入探討命名空間的定義、使用技巧、using 指令、巢狀結構以及實務上的最佳實踐。

什麼是命名空間？

簡單來說，命名空間是一個邊界，它將一組型別名稱（類別、結構、介面、列舉、委派等）包裹在一個唯一的名稱底下。就像檔案系統中的資料夾：同樣名為 Program.cs 的檔案可以存在於不同資料夾中而不衝突，同樣名為 User 的類別也可以存在於 MyApp.Models 和 ThirdParty.Models 兩個命名空間中。

定義與基本語法

使用 namespace 關鍵字宣告命名空間：

namespace MyCompany.MyProject.Module {
    // 類別、介面、結構等型別定義
    public class Customer { }
}

慣例上，命名空間採用 PascalCase 命名，並以公司名稱或專案名稱作為前綴（如 Microsoft.AspNetCore），以確保全域唯一性。

存取命名空間中的成員

若要使用某命名空間中的型別，有兩種方式：

完整限定名稱：在型別名稱前加上命名空間，例如 MyCompany.MyProject.Module.Customer。
using 指令：在檔案頂端引入命名空間，之後即可直接使用型別名稱。

`using` 指令詳解

using 指令告訴編譯器：「後續程式碼將使用該命名空間中的型別，請自動補全完整名稱」。

using System;           // 引入 System 命名空間
using MyApp.Models;     // 引入自訂命名空間

// 現在可以直接寫 Console.WriteLine，而不必寫 System.Console.WriteLine
Console.WriteLine("Hello World");

進階用法：

using static：引入靜態類別的靜態成員（C# 6.0+），如 using static System.Math; 後可直接寫 Sqrt(4)。
using alias = namespace;：為命名空間或型別建立別名，解決同名衝突，如 using ProjectA = MyCompany.ProjectA;。

巢狀命名空間

命名空間可以巢狀定義，形成階層結構：

namespace MyApp {
    namespace Services {
        public class UserService { }
    }
    namespace Repositories {
        public class UserRepository { }
    }
}

也可簡寫為單行（C# 10+ file-scoped namespace 除外）：

namespace MyApp.Services { public class UserService { } }
namespace MyApp.Repositories { public class UserRepository { } }

存取巢狀成員時，使用點號串連：MyApp.Services.UserService。

實戰範例：解決類別名稱衝突

假設專案中同時使用兩個第三方套件，皆定義了 Logger 類別：

namespace LibA { public class Logger { public void Log(string msg) => Console.WriteLine($"[LibA] {msg}"); } }
namespace LibB { public class Logger { public void Log(string msg) => Console.WriteLine($"[LibB] {msg}"); } }

class Program {
    static void Main() {
        // 使用完整限定名稱區分
        var loggerA = new LibA.Logger();
        var loggerB = new LibB.Logger();
        loggerA.Log("訊息 A");
        loggerB.Log("訊息 B");
    }
}

輸出：