🎯 条款 18：让接口容易被正确使用，不易被误用
（Make interfaces easy to use correctly and hard to use incorrectly）
这是 C++ 接口设计中最重要的指导原则之一。一个好的接口不仅要功能强大、设计精良，更重要的是它要引导用户自然地、正确地使用它，并主动阻止用户犯错。
1. 易于正确使用 (Easy to Use Correctly)
设计接口时，应该使用户无需记忆额外的规则或避免某些操作，就能自然而然地正确使用。
示例：std::unique_ptr
std::unique_ptr 在设计上就体现了“易于正确使用”：
- 自动资源管理： 用户无需手动调用
delete（遵守了条款 13）。 - 单一所有权： 禁止拷贝构造和拷贝赋值。这意味着用户如果尝试拷贝一个
unique_ptr，编译器会直接报错，从而阻止了“双重释放（double delete）”这类资源所有权转移的常见错误。
2. 不易被误用 (Hard to Use Incorrectly)
这是条款 18 的核心，设计者可以通过多种机制来阻止用户犯下常见的错误。
A. 引入新类型，限制类型转换
问题： 假设我们有一个处理日期的类，用户可能会传入错误的整数来表示月份。
class Date {
public:// 允许用户传入任何 int，可能传入 0 或 13 等非法值Date(int month, int day, int year);
};
解决方案： 为参数（如月份）创建新的强类型。这样用户只能传入特定的类型对象，而不是随意的整数。
// 引入强类型
struct Month { explicit Month(int m) : val(m) {} int val; };
struct Day { explicit Day(int d) : val(d) {} int val; };
struct Year { explicit Year(int y) : val(y) {} int val; };class Date {
public:// 强制用户传入 Month 对象，而不是 intDate(const Month& m, const Day& d, const Year& y);
};// 正确使用：
Date d(Month(3), Day(30), Year(2025));
// 误用：编译器报错，因为 3 不是 Month 类型
// Date d(3, 30, 2025);
通过这种方式，我们利用 C++ 的类型系统，把运行时错误（传入非法整数）转化为编译时错误（类型不匹配），从而防止误用。
B. 限制对象的有效性：const
如果某个对象不应该被修改，就应该将其声明为 const。这是最简单、最有效的防止误用方法。
// 确保这个对象在程序执行过程中不会被修改
const SomeClass immutableObject;
C. 返回智能指针，消除资源泄漏
问题： 接口返回原始指针 (Raw Pointer)，用户忘记 delete 导致泄漏（条款 13）。
// 误用：返回原始指针，用户可能忘记 delete
Widget* createWidget();
解决方案： 接口返回智能指针（例如 std::unique_ptr），确保资源的自动管理。
// 正确：返回智能指针，资源自动被管理
std::unique_ptr<Widget> createWidget();
D. 阻止跨 DLL/SO 边界的内存泄漏
当程序在动态链接库（DLL/SO）之间传递对象时，如果在一个 DLL 中用 new 分配内存，在另一个 DLL 中用 delete 释放，可能会因为使用了不同的堆管理器而导致程序崩溃或泄漏。
解决方案： 确保 DLL 接口只返回智能指针，并且不在接口中暴露原始指针或容易引起问题的内存管理函数。或者提供配套的工厂函数和销毁函数，让内存的分配和释放都发生在同一个模块内。
总结
设计优秀的接口，就是将使用者的错误降到最低。这是通过以下策略实现的：
- 一致性： 保持接口行为的一致性（例如，
size()函数对所有容器都返回元素数量）。 - 内置防错： 使用类型系统（例如
Month类型）、const修饰符、智能指针等，将运行时错误转移到编译期，从而强制用户正确地使用接口。 - 封装实现： 隐藏实现细节，只暴露必要的操作，减少用户的选择和出错的可能性。