C++ 中用 namespace 取代 static 結構體的最佳實踐

編輯：關於C語言

在 C++ 開發中，開發者常嘗試使用 struct 搭配 static 成員來模擬命名空間，以便存放常數或工具函數。然而，這種做法不僅語法繁瑣，還容易引發編譯錯誤。本文探討為何 namespace 是更優雅、更符合語言設計的替代方案。

問題場景：想用結構體存放數學常數

假設你需要定義一組數學常數（如鹽密度 gamma = 2350 kg/m³），初步寫法如下：

struct Consts {
    static const double gamma;
};

const double Consts::gamma = 2350;

這能運作，但若有超過 10 個浮點常數，每個都要寫 static const 顯得冗長。有人嘗試改寫為：

static const struct Consts {
    double gamma;
};

const double Consts::gamma = 2350; // 編譯錯誤

結果報錯：member function redeclaration not allowed 和 a nonstatic data member may not be defined outside its class。根本原因在於 static 修飾的是結構體變數而非成員，且靜態成員仍需類外定義，語法不通。

解決方案：直接使用 namespace

C++ 原生提供 namespace 機制，專為「將標識符組織在命名空間下」而設計：

namespace Consts {
    const double gamma = 2350;
    // 可繼續添加其他常數，無需 static、無需類外定義
}

調用方式完全一致：Consts::gamma。更何況，namespace 支持跨文件擴展、避免全域汙染，且符合 C++ 語義模型。

實際代碼對比

以下展示頭文件寫法差異：

// ❌ 結構體靜態成員寫法（繁瑣且易錯）
#ifndef MY_HPP
#define MY_HPP

struct MyStruct {
    static int x;
};
void fun();

#endif

// MyStruct.cpp 需額外定義：int MyStruct::x = 100;

// ✅ namespace 寫法（簡潔、直觀）
#ifndef MY_HPP
#define MY_HPP

namespace MyNS {
    int x = 100; // 直接定義初始化
}
void fun();

#endif