原文鏈接：API Design Principles - Qt Wiki
基于Gary的影響力上 Gary Gao 的譯文稿：C++的API設計指導
譯文發在酷殼 - CoolShell：API設計原則， 2017-07-25

API設計原則 - Qt官網的設計實踐總結

🍎 譯序

Qt的設計水準在業界很有口碑，一致、易于掌握和強大的API是Qt最著名的優點之一。此文既是Qt官網上的API設計指導準則，也是Qt在API設計上的實踐總結。雖然Qt用的是C++，但其中設計原則和思考是具有普適性的（如果你對C++還不精通，可以忽略與C++強相關或是過于細節的部分，仍然可以學習或梳理關于API設計最有價值的內容）。整個篇幅中有很多示例，是關于API設計一篇難得的好文章。

需要注意的是，這篇Wiki有一些內容并不完整，所以，可能會有一些閱讀上的問題，我們對此做了一些相關的注釋。

感謝酷殼博主 陳皓的全文審校，并對難點和要注意的地方給出貼心的說明和譯注。

API設計原則

一致、易于掌握和強大的API是Qt最著名的優點之一。此文總結了我們在設計Qt風格API的過程中所積累的訣竅（know-how）。其中許多是通用準則；而其他的則更偏向于約定，遵循這些約定主要是為了與已有的API保持一致。

雖然這些準則主要用于對外的API（public API），但在設計對內的API（private API）時也推薦遵循相同的技巧（techniques），作為開發者之間協作的禮儀（courtesy）。

如有興趣也可以讀一下 Jasmin Blanchette 的Little Manual of API Design (PDF) 或是本文的前身 Matthias Ettrich 的Designing Qt-Style C++ APIs。

---

總結

以上是生活随笔為你收集整理的API设计原则 - Qt官网的设计实践总结的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。