C++ 命名空間 namespace 完整指南

大型專案中類別、函數名稱衝突在所難免。C++ 透過 namespace 機制（類似 Java 的 package）解決命名衝突，是企業級開發必備技能。

命名衝突場景

• 第三方庫函數與自定義函數同名（如 HelloWorld()）
• 團隊協作：A 模組 struct Node、B 模組 struct Node 結構不同
• 標準庫符號與用戶代碼衝突

定義命名空間

// Hello.h
#pragma once
namespace SH {
    class Hello {
    public:
        Hello(); ~Hello();
        void SayHello();
    };
    void HelloWord(); // 命名空間內自由函數
}

// 可跨檔案延續同一命名空間
namespace SH {
    void Hello2Sunly();
}

實作檔案

// Hello.cpp
#include "Hello.h"
#include 
using std::cout; using std::endl;

namespace SH {
    Hello::Hello() {}
    Hello::~Hello() {}
    void Hello::SayHello() { cout << "how are you!" << endl; }
    void HelloWord() { cout << "Hello World!" << endl; }
    void Hello2Sunly() { cout << "Hello Sunly!" << endl; }
}

// 也可用全域作用域運算符定義
SH::Hello::Hello() {}
void SH::HelloWord() { ... }

三種使用方式

1. 完整限定名稱（最安全）

int main() {
    std::cout << "Hello World!" << std::endl;
    SH::Hello h; h.SayHello();
}

2. using 声明（推薦折衷）

using std::cout; using std::endl;
using SH::Hello; using SH::HelloWord;

int main() {
    cout << "Hello World!" << endl;
    Hello h; h.SayHello();
    HelloWord();
}

僅引入需要的符號，作用域從聲明處到檔案結尾。

3. using 指示（便利但危險）

using namespace std;
using namespace SH;

int main() {
    cout << "Hello World!" << endl;
    Hello h; h.SayHello();
    Hello2Sunly();
}

將整個命名空間注入當前作用域，易發生衝突。

最佳實務總結

1. 標頭檔禁用 using namespace — 汙染所有包含者
2. 原始檔優先用 using 命名空間::符號; — 精確控制
3. 局部範圍：函式內部可用 using namespace std; 限制汙染
4. 巢狀命名空間：namespace A::B { ... } (C++17) 或 namespace A { namespace B { ... } }
5. 匿名命名空間：namespace { ... } 限制符號僅在本編譯單元可見（替代 static）