在C++中返回int做错误检查是否为不良实践？有哪些替代方案？

阿华AIGC实验室

2026-5-29

在C++中用int返回错误码是不良实践吗？

这个问题没法直接给个“是”或“否”的答案——得看你具体的代码场景和上下文。毕竟C是兼容C的，在一些特定场景里，用int返回错误码完全合理，但如果是写纯现代C代码，它确实算不上最佳实践，甚至会带来不少坑。

什么时候int错误码不算“不良实践”？

需要和C代码交互时：如果你的函数要给C代码调用，那int错误码是标准操作——C没有异常机制，对方根本没法处理C++异常，这时候用int是最稳妥的选择。
错误是可预期且可忽略的小问题：比如某个辅助函数返回“是否成功刷新了缓存”，这种场景下返回0（成功）或1（失败）确实比抛异常轻量，也符合你提到的“调用方可忽略”的灵活度。
性能极度敏感的底层场景：比如高频调用的内核级函数，异常的栈展开开销可能会成为瓶颈（不过现在编译器优化已经很强了，这个场景其实越来越少见）。

为啥纯C++代码里不推荐用int错误码？

可读性拉胯：你得自己定义一堆“魔法值”——比如0是成功，-1是参数错，1是资源不足，新接手代码的人得翻遍注释或头文件才能搞懂每个值的含义，远不如自定义错误类型清晰。
太容易被忽略：这既是你说的优势，也是致命劣势。很多开发者赶工或者没经验时，会直接忽略返回值，比如写fopen("file.txt", "r");却不检查结果，导致后续逻辑在错误状态下运行，埋下难排查的bug。
没法带详细错误信息：int只能表示错误类型，没法附带“哪个参数无效”“资源不足时剩余空间多少”这类细节，排查问题时简直头疼。
不符合C++惯用法：C的设计哲学里，异常是用来处理异常情况的，错误码更适合常规分支逻辑。混用的话会让代码风格混乱，其他C开发者读起来特别别扭。

更优的替代方案

1. 用强类型的错误枚举/类

如果不想用异常，至少别用裸int，换成强类型枚举或者自定义错误类：

enum class FileError {
    Success,
    NotFound,
    PermissionDenied,
    DiskFull
};

FileError open_file(const std::string& path) {
    if (!std::filesystem::exists(path)) {
        return FileError::NotFound;
    }
    // 其他逻辑...
    return FileError::Success;
}

这样调用者一眼就能看懂错误类型，编译器还能帮你做类型检查，避免把错误码和其他int值搞混。

2. C++23的`std::expected`（首选！）

这是C++23引入的标准工具，专门解决“要么返回结果，要么返回错误”的场景，完美替代裸错误码：

#include <expected>
#include <string>

std::expected<FILE*, FileError> open_file(const std::string& path) {
    FILE* fp = fopen(path.c_str(), "r");
    if (!fp) {
        return std::unexpected(FileError::NotFound);
    }
    return fp;
}

// 调用示例
auto result = open_file("test.txt");
if (result) {
    // 处理正常结果*result
} else {
    // 处理错误result.error()
}

它既保留了错误码的灵活性，又强制调用者考虑错误情况（当然你也可以用value()直接取结果，出错会抛异常），还能携带详细错误信息，比裸int安全太多。

3. 异常机制（适合真正的异常场景）

对于那些程序无法正常继续运行的异常情况（比如内存不足、依赖的配置文件丢失），抛出异常是最符合C++风格的选择：

#include <stdexcept>
#include <fstream>

std::ifstream open_file(const std::string& path) {
    std::ifstream file(path);
    if (!file.is_open()) {
        throw std::runtime_error("Failed to open file: " + path);
    }
    return file;
}

// 调用示例
try {
    auto file = open_file("test.txt");
    // 处理文件
} catch (const std::exception& e) {
    std::cerr << "Error: " << e.what() << std::endl;
}

异常的优势很明显：