C++Builder 全域變數正確宣告與使用全攻略

前言：為什麼全域變數在 C++Builder 中容易出錯？

C++Builder 採用單元為單位編譯，每個 .cpp 編譯成獨立的 .obj，再由連結器合併。若在標頭檔直接定義變數，每個引用該標頭的單元都會得到一份獨立副本，導致「同名不同址」的災難。本文詳細說明三種正確做法，並解析 VCL 內部實作機制。

錯誤示範：標頭檔直接定義

// Globals.h - 錯誤寫法
#ifndef GlobalsH
#define GlobalsH
#include <Classes.hpp>
AnsiString UserName;  // 每個 include 此檔的單元都會產生一份副本
#endif

後果：編譯器警告「多重定義」，各單元操作各自的 UserName，賦值不互通。

方法一：專案主檔定義 + extern 宣告（標準 C++ 做法）

步驟 1：在專案主檔定義實體

// Project.cpp (或 .cbp 專案指定的主檔)
#include <vcl.h>
#pragma hdrstop
#include "MainForm.cpp"
// 全域變數實體定義（只能出現一次）
AnsiString UserName;

WINAPI WinMain(HINSTANCE, HINSTANCE, LPSTR, int)
{
    try {
        Application->Initialize();
        Application->CreateForm(__classid(TMainForm), &MainForm);
        Application->Run();
    } catch (...) { /* ... */ }
    return 0;
}

步驟 2：在標頭檔用 extern 宣告

// Globals.h
#ifndef GlobalsH
#define GlobalsH
#include <Classes.hpp>
// 僅宣告，不配置儲存空間
extern AnsiString UserName;
#endif

步驟 3：需使用的單元 include 標頭檔

// Unit2.cpp
#include "Globals.h"
void SomeFunction() {
    UserName = "Admin";  // 正確存取同一個實體
}

方法二：VCL 風格 — extern PACKAGE（推薦用於元件庫/套件）

VCL 將 Application, Screen 等應用程式級全域物件以此方式導出，支援運行時套件 (BPL) 正確共享符號。

實作範例

// Globals.cpp - 實作檔
#pragma hdrstop
#include "Globals.h"
#pragma package(smart_init)  // 智慧初始化，支援 BPL
AnsiString UserName = "YinJiajun";  // 定義並初始化

// Globals.h - 標頭檔
#ifndef GlobalsH
#define GlobalsH
#include <Classes.hpp>
// PACKAGE 宏在建構套件時展開為 __declspec(dllexport)，使用時為 dllimport
extern PACKAGE AnsiString UserName;
#endif

關鍵點解析

• #pragma package(smart_init)：確保套件載入/卸載時正確初始化/終結全域物件。
• PACKAGE 宏定義於 SysInit.hpp，視專案類型自動切換匯入/匯出屬性。
• 適用於：元件庫、設計時/執行時套件、需跨 BPL 邊界共享的全域狀態。

方法三：命名空間 + 單例模式（現代 C++ 風格）

避免全域命名空間污染，封裝存取邏輯，支援延遲初始化與執行緒安全。

// AppContext.h
#ifndef AppContextH
#define AppContextH
#include <System.hpp>
#include <mutex>

namespace AppContext {
    class GlobalState {
    private:
        AnsiString FUserName;
        static GlobalState* instance;
        static std::mutex mtx;
        GlobalState() : FUserName("Guest") {}
    public:
        static GlobalState& Instance() {
            std::lock_guard lock(mtx);
            if (!instance) instance = new GlobalState();
            return *instance;
        }
        AnsiString GetUserName() const { return FUserName; }
        void SetUserName(const AnsiString& name) { FUserName = name; }
    };
    // 便利函數
    inline AnsiString UserName() { return GlobalState::Instance().GetUserName(); }
    inline void SetUserName(const AnsiString& n) { GlobalState::Instance().SetUserName(n); }
}
#endif

使用方式：AppContext::SetUserName("Admin"); / AppContext::UserName()

VCL 內建全域物件參考

最佳實務建議

1. 能不用全域就不用：優先考慮傳參數、單例、依賴注入、服務定位器。
2. 必須用時：採用 extern + 標頭檔宣告，或 namespace + 單例。
3. 跨 BPL 共享：務必使用 extern PACKAGE + #pragma package(smart_init)。
4. 初始化順序：全域物件建構順序跨編譯單元不定序，避免相互依賴；改用 function-local static (Meyer's Singleton) 保證首次使用時初始化。
5. 執行緒安全：多執行緒存取全域資料需加鎖或使用無鎖資料結構。
6. 命名規範：加前綴如 g_, G, App:: 區分區域變數。

結語

全域變數是把雙面刃。在 C++Builder 中，理解編譯/連結模型與 VCL 的 PACKAGE 機制，才能正確、安全地使用全域狀態。現代專案建議以「模組化、可測試、低耦合」為目標，將全域狀態最小化、封裝化。

1. 上一篇文章： C/C++ 學習路徑全攻略：從入門到商業開發的完整指南
2. 下一篇文章： C/C++ 函式呼叫慣例完整解析：__cdecl、__stdcall、__fastcall、thiscall 與名稱修飾

關於C++

Effective Modern C++ 條款 19：用 shared_ptr 管理共享所有權資源

std::shared_ptr 實現了「垃圾回收器般的自動生

C++ 中的重名問題與命名空間

為什麼需要命名空間 C++ 引入 namespace 解決大

C++ 繼承基礎代碼示例：訪問控制與成員繼承

代碼示例 #include using namespac

C++ 矩陣運算實作：4x4 乘法/轉置、3x3 伴隨矩陣求逆完整代碼

C++ 矩陣運算實作：4x4 乘法/轉置、3x3 伴隨矩陣求