拒绝“面条代码”,做有架构思维的 Go API 设计师

本文永久链接 – https://tonybai.com/2025/12/08/api-design-pattern-and-implementation 大家好,我是Tony Bai。 在 Go 语言的圈子里摸爬滚打这么多年,我经常被问到这样一个问题: “Tony,我已经熟悉了 Go 的语法,也会用 Gin 写增删改查(CRUD)了,为什么我写的 API 还是经常被前端吐槽?为什么业务逻辑稍微一变,我的代码就要推倒重来?为什么我的接口文档和代码永远对不上?” ...

December 8, 2025 · 7 min · Tony Bai

无聊的API是最好的API:从系统设计到接口契约的九条法则

本文永久链接 – https://tonybai.com/2025/08/29/good-api-design 大家好,我是Tony Bai。 在解读《Everything I know about good system design》一文时,我们曾提炼出一个核心观点:“无聊即可靠”。这个看似反直觉的法则,在追求创新与复杂的软件工程世界里,如同一股清流。现在,这个“无聊”哲学将从宏观的系统设计,延伸至微观但至关重要的领域——API设计。 Sean Goedecke在其后续力作《Everything I know about good API design》中,再次强调了这一理念。他认为,一个伟大的API,必然是“无聊”的。它不应追求新奇或有趣,而应像一把用了多年的锤子,让使用者拿起就能用,无需思考。 ...

August 29, 2025 · 9 min · Tony Bai