19 | API设计：构建用户喜爱、健壮可靠的公共接口

1. 设计良好的API能够提升开发效率和库的生命力，Go包的公共API由导出的函数、变量、常量和类型构成，这些构成了包与外部世界交互的显性契约。 2. 易用性是API设计中最直观且最影响用户体验的因素，一个易用的API应该简单、清晰，让用户第一次就能上手，而在追求优秀API设计的道路上，简单性扮演着至关重要的角色。 3. 安全性方面，API需要遵循最小权限/暴露原则，进行输入校验，提供并发安全承诺，并避免不必要的panic和os.Exit，同时提供资源管理与关闭机制。 4. API一旦发布并被用户依赖，保持其稳定性就至关重要，需要尽最大努力保持向后兼容，遵循语义版本控制（SemVer），并为未来扩展设计。 5. 高效性——避免不必要的性能陷阱，需要避免不必要的内存分配，关注资源消耗，以及提供性能文档和Benchmark代码. 6. 惯例性——写出“Go味道”的API，包括命名惯例、错误处理、参数与返回值的惯例等. 7. `http.ListenAndServe(addr string, handler http.Handler)` 在易用性方面做得好，因为它提供了简单的参数和清晰的功能，让用户能够轻松上手。 8. 在安全性方面，该API遵循了最小权限/暴露原则，提供了并发安全承诺，并避免了不必要的panic和os.Exit，符合良好的安全性设计原则。 9. 该API体现了Go接口设计和依赖倒置原则，通过参数类型 `handler http.Handler` 实现了依赖注入，使得用户可以自定义处理器，增加了灵活性和可扩展性。