C++ 字符串转整数：stoi/stol/stoll 避坑与实战

做后台开发时，解析配置文件或网络请求参数离不开字符串转换。很多人惯性使用 atoi，觉得它简单直接，结果在测试环境跑得好好的，一上线数据稍大就崩了。atoi 失败返回 0，这简直是灾难现场，因为无法区分“真的是 0"还是“转换失败”。现代 C++ 推荐使用 <string> 库里的家族函数，虽然名字长得像，但背后藏着不少讲究。

这三个函数对应着不同的大小范围。stoi 负责普通整型，stol 对应长整型，stoll 则用于 64 位大整数。很多时候程序崩溃不是因为逻辑错乱，而是数值越界导致内存溢出，选对函数是第一步。比如读取用户年龄通常用 stoi，但涉及 ID 哈希或时间戳时，stoll 才是安全的选择。

当输入字符串不规范时，行为差异决定了程序的健壮性。stoi("12a") 会抛出标准异常，而不是静默返回错误值。这意味着我们不必依赖魔法数字去判断返回值，而是应该拥抱异常机制。在实际工程中，建议将核心转换逻辑包裹在 try...catch 块中。如果捕获到 std::invalid_argument，说明压根没数字；若是 std::out_of_range，则是数字太大塞进变量里爆了。这种处理方式比单纯检查 if (val < 0) 要可靠得多。

有些业务场景下，字符串里混杂着单位或其他字符，比如解析配置项 "timeout=30s"。这时候利用 pos 参数能精准定位数字结束的位置，实现边转换边切分。调用格式为 stoi(str, &pos)，返回的 pos 告诉我们在原串的哪里停止了，剩下的部分可以交给后续逻辑处理。这招在处理日志或半结构化文本清洗时非常顺手，无需正则就能快速提取首段数字。

进制转换也是常被忽略的功能点。默认情况下，所有函数都按十进制处理。如果遇到十六进制配置如 "0xFF"，直接转会有问题。只需传入第二个参数指定基数，或者设为 0 让函数自动识别前缀。stoi(hex_str, nullptr, 16) 显式声明十六进制是最稳妥的写法，而 stoi(str, nullptr, 0) 则会根据前缀自动匹配 0x 或 0 开头模式。不过要注意，自动识别模式下，纯数字字符串依然优先视为十进制，不会因为写了 "89" 就变二进制。

最后别忘了预处理环节。虽然函数内部会跳过前置空格，但如果面对空指针或全空格字符串，仍然可能触发异常。在生产环境中，建议在调用转换前增加非空校验，并清理掉多余的控制字符。把边界情况处理在前面，能大幅减少运行时抛出的概率。

转换类型看似小事，却是系统稳定性的基石。掌握这三个函数的细节，特别是异常处理和进制控制，能让你的代码在面对脏数据时更具韧性。记住，永远不要相信未经验证的用户输入，哪怕只是简单的数字，也值得多加一层防御。