🎯 什麼情境該想到我

當你在設計一個模組/函式庫/API 的公開介面,決定「露出什麼、藏什麼」時。

⚙️ 怎麼用(四原則)

  1. 隱藏實作(資訊隱藏):使用者只看到介面,內部可自由改。
  2. 簡單:介面小而好用;常見用法要容易,罕見用法才可以複雜。
  3. 正交:功能之間彼此獨立、可自由組合,不重疊、不互相牽制。
  4. 一致:命名、參數順序、錯誤處理風格全體一致,可預期。

好的介面讓呼叫端「很難用錯」。

🧪 我實際套用的紀錄

  • 2026-07-14:(待填)

⚠️ 注意

  • 介面一旦公開就難改;上線前多想一輪,寧可先小再擴。

🔗 相關工具