現象
靜態庫中類成員函數加 inline，庫編譯通過，但鏈接使用該庫的項目時提示 LNK2001: 無法解析的外部符號（針對該 inline 函數）。去掉 inline 重新編譯庫與項目則正常。
原因
inline 提示編譯器進行內聯展開，函數體不生成獨立符號，調用點直接嵌入機器碼。- 靜態庫本質是目標文件歸檔，若函數被內聯，庫中不包含該函數的符號定義。
- 外部項目鏈接時，若該函數未被內聯（如跨編譯單元調用、函數地址被取、虛函數、編譯器決定不內聯），鏈接器在庫中找不到符號，報錯。
解決方案
- 導出接口不加 inline： 作為庫公共 API 的函數，不要聲明
inline，確保符號導出。
- 強制實例化（模板除外）： 在庫的某個 .cpp 中顯式調用一次該函數（如 `void force_inline() { MyClass::inlineFunc(); }`），生成符號，但失去內聯優勢。
- 頭文件內聯 + 庫中不導出： 若極度追求性能，將函數實現完全放在頭文件（隱式 inline），不放入庫編譯單元，使用方包含頭文件即可內聯。但會增加編譯依賴、代碼膨脹。
- 使用 __forceinline (MSVC) / __attribute__((always_inline)) (GCC) 謹慎控制。
最佳實踐
庫的公共接口（.h 中聲明，.cpp 中實現）不要加 inline。 僅在頭文件中定義的函數（隱式 inline）或模板函數適合內聯。性能敏感熱點路徑可通過 PGO (Profile Guided Optimization) 由編譯器自動決定內聯。
