Integer.parseInt() 使用方法详解

Integer.parseInt() 是一个看似简单却暗藏陷阱的Java核心方法——它对输入字符串极其苛刻：拒绝null、空串、首尾空格、非数字字符（含中文、逗号、错误符号）、非法进制前缀，甚至会静默溢出导致数据错乱；本文直击开发中高频踩坑点，从精准前置校验（trim+正则粗筛）、异常捕获策略，到与valueOf()的本质区别、多进制字符串去前缀处理，再到大数安全替代方案（BigInteger.intValueExact()等），全面揭示如何真正可靠地将字符串转为int，避免线上因一个空格或超长数字而崩溃。

Integer.parseInt() 会直接抛出 NumberFormatException

它不接受 null、空字符串、带空格的字符串、非数字字符（包括中文数字、逗号、+/- 号位置错误）、超出 int 范围的数字。一旦不符合规范，立刻崩溃，不会返回默认值或 null。

常见报错信息：java.lang.NumberFormatException: null、java.lang.NumberFormatException: For input string: ""、java.lang.NumberFormatException: For input string: "123abc"

• 先用 str == null || str.trim().isEmpty() 做前置校验
• 再用 str.trim().matches("-?\\d+") 粗筛格式（注意：这不能校验溢出）
• 真正安全的做法是捕获 NumberFormatException 并处理异常分支

parseInt() 和 valueOf() 的区别不只是返回类型

Integer.parseInt("123") 返回基本类型 int；Integer.valueOf("123") 返回 Integer 对象，且内部使用了缓存（-128 到 127 范围内复用对象）。

• 需要装箱或参与泛型容器（如 List）时，优先用 valueOf()
• 做纯数值计算、避免隐式装箱开销时，用 parseInt()
• 二者在解析失败时行为完全一致——都抛 NumberFormatException

带进制解析必须确认字符串不含前缀

Integer.parseInt("0xFF", 16) 会失败，因为 "0xFF" 含有 0x 前缀，而该方法不识别任何前缀，只认纯数字字符（0–9, a–f/A–F）。

• 十六进制字符串要先去掉 "0x" 或 "0X"，再调用 parseInt(str.substring(2), 16)
• 八进制同理：去掉开头的 "0"（注意不是所有以 0 开头的都是八进制，Java 字面量才这样，字符串里只是普通字符）
• 二进制只支持字符 '0' 和 '1'，不接受 "0b101" 这类前缀

大数或不确定范围时别硬刚 parseInt()

如果原始字符串可能超过 Integer.MAX_VALUE（2147483647）或小于 Integer.MIN_VALUE（-2147483648），parseInt() 会静默溢出——比如 parseInt("2147483648") 返回 -2147483648，而不是报错。

• 想严格拒绝溢出，改用 Integer.parseUnsignedInt()（仅限非负数）或 Long.parseLong() + 范围检查
• 更稳妥的是用 BigInteger：先 new BigInteger(str)，再调用 intValueExact() —— 它会在溢出时明确抛 ArithmeticException
• Web 表单或日志解析等不可信输入场景，务必假设字符串长度 > 10 就存在溢出风险

实际用的时候，最常被忽略的是 trim() 和溢出校验。很多人写了 parseInt(s) 就以为稳了，结果线上因为前端多传了个空格或后端日志里混进了不可见字符直接挂掉。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Integer.parseInt() 使用方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。