相同點
- **邏輯組織**:兩者皆用於組織類型、避免命名衝突、控制可見性。
- **存取控制**:配合修飾符 (
public/internal vs public/package-private) 實現封裝。
- **匯入機制**:
using / import 簡化類型名稱引用。
核心差異
1. 物理結構綁定
| 特性 | C# namespace | Java package |
| 目錄結構要求 | **無強制綁定** | **強制一致** (package 路徑 = 目錄路徑) |
| 單一檔案多命名空間 | ✅ 允許 | ❌ 單一檔案僅屬一個 package |
| 跨檔案同命名空間 | ✅ 允許 | ✅ 允許 (同目錄下多檔案) |
| 巢狀命名空間 | namespace A.B.C 或 namespace A { namespace B { } } | 無子套件概念,a.b 與 a.b.c 平級 |
2. 命名慣例
// C#: PascalCase,通常以公司/專案開頭
namespace MyCompany.MyProject.Module { }
// Java: 全小寫,反向域名
package com.mycompany.myproject.module;
3. 匯入語法差異
// C#: using 指令 (頂層/命名空間內)
using System.Collections.Generic;
using static System.Math; // 靜態導入
using Str = System.String; // 別名
using Config = MyApp.Configuration; // 類型別名
// Java: import (頂層)
import java.util.List;
import static java.lang.Math.*; // 靜態導入
// 無別名機制 (Java 10+ var 除外)
4. 存取修飾符映射
| C# | Java | 說明 |
public | public | 完全公開 |
internal | package-private (預設) | 組件/套件內可見 |
protected internal | 無直接對應 | 同組件或衍生類 |
private protected | 無直接對應 | 同組件且衍生類 |
private | private | 僅類內 |
5. 組件 vs JAR
- C#: **組件** 是部署單元,包含一或多個模組,命名空間跨組件可見 (需引用)。
- Java: **JAR** 是封裝單元,套件結構嵌入 JAR 內,類路徑掃描發現類別。
遷移指南
| Java 概念 | C# 對應 | 注意事項 |
| package | namespace | C# 不強制目錄結構 |
| import static | using static | C# 7.0+ |
| package-private | internal | C# 預設為 internal |
| jar 依賴 | NuGet 套件 / 專案引用 | 組件版本管理更豐富 |
| 模組系統 (JPMS) | 無直接對應 | .NET 組件 + 內部可見性近似 |
最佳實踐
- C#: 即使不強制,**建議目錄結構對應命名空間** 便於導航。
- 避免過深巢狀 (超過 4-5 層),使用
using 別名簡化長名稱。
- 公開 API 命名空間穩定,內部實現用
Internal 或獨立 .Internal 命名空間。