.NET 命名空間規範：構建清晰可維護的企業級代碼庫

為什麼需要命名空間規範？

COM 時代僅能用「專案名.類名」兩級標識，極易衝突。.NET 允許深層嵌套命名空間，但若無統一規劃，反而會導致混亂。良好的命名空間結構能：

• 避免第三方庫命名衝突（以公司名為根）。
• 模擬 .NET Framework 結構，降低學習成本。
• 便於文檔生成工具（如 NDoc）產出統一 MSDN 風格文檔。

命名空間構建原則

1. 公司標識符為根

格式：CompanyName.ProjectName.Subsystem。例如：XYZCompany.Accounting.Payroll。

2. 依據代碼用途細分

• 特定業務項目：CompanyName.ProjectName.Module
• ASP.NET 站點：CompanyName.ProjectName.Website
• Web Services：CompanyName.ProjectName.WebServices
• 跨企業共享類庫：不含項目名，模擬 Framework 結構，如 XYZCompany.Data.SqlClient、XYZCompany.Diagnostics。

3. 類名唯一性與後綴規範

• 避免與 Framework 類名衝突（如自定義日誌類用 EventLogger 而非 EventLog）。
• 遵循微軟後綴約定：Attribute 類以 Attribute 結尾，異常類以 Exception 結尾。

VSS 專案目錄映射

頂層建立兩個節點：

• XYZ Enterprise .NET Class Library（企業共享代碼）
• XYZ Project .NET Class Library（專項代碼）

其下以公司名為根節點，後續層級以文件夾替代命名空間中的點（.），專案文件名使用完整命名空間名稱。

總結

建立標準命名空間結構非一蹴而就，需團隊協作與持續執行。趁 .NET 採用早期確立規範，避免日後演變成難以維護的「深層嵌套 ProgID 代碼庫」。