Python int()函数用法：字符串与浮点数转整数详解

在 Python 编程中，将外部输入或计算产出的数据转换为整型是高频基础操作。内置的 int() 函数同时承担了浮点数向下截断和字符串文本解析两种截然不同的任务。许多初学者在处理 int("3.14") 时经常遭遇 ValueError 异常，这源于未能厘清该函数在接收不同数据类型时的内部解析机制。本文将系统剖析 int() 函数的参数规范、浮点数向零截断的本质、字符串按进制解析的规则以及常见报错的解决途径。

一、int() 函数的定义与核心参数分流

int() 是 Python 的内置类型构造器，其完整的调用语法如下：

int(x=0)
int(x, base=10)

根据传入参数的不同，int() 在内部主要执行两条分流逻辑：

• 单参数数值转换：当传入参数为浮点数（float）、布尔值（bool）或已经为整数的对象时，直接执行数值截断或类型转换，此时不能传递 base 参数。
• 双参数进制解析：当传入参数为字符串（str）或字节序列（bytes）时，可以指定 base 参数（默认取值 10）。Python 会按照指定基数解析文本内容；若此时传入的是非字符串类型，解释器将抛出 TypeError。

图1：int() 函数根据参数类型执行不同的转换与校验分支

二、浮点数转整数：向零截断与取整函数对比

当给 int() 传入浮点数时，其行为并不是“四舍五入”（rounding），也不是数学上的“向下取整”（floor），而是直接舍弃小数部分，向坐标轴 0 的方向截断。

# 示例：正浮点数向零截断
print(int(3.14))   # 示例输出：3
print(int(3.99))   # 示例输出：3

# 示例：负浮点数向零截断
print(int(-3.14))  # 示例输出：-3
print(int(-3.99))  # 示例输出：-3

截断与 floor、round 的核心差异

在涉及坐标计算、财务舍入或索引计算时，必须区分 int() 与其他取整工具的区别：

• int(x)：向零靠近。对于正数表现为向下截断，对于负数表现为向上截断（int(-3.9) == -3）。
• math.floor(x)：严格向负无穷方向取整（math.floor(-3.9) == -4）。
• round(x)：在 Python 3 中采用“银行家舍入法”（四舍六入五成双），就近舍入到最近的偶数。

图2：向零截断（int）与向下取整（math.floor）处理负浮点数时的方向差异

三、字符串转整数：格式约束与多进制转换

当传入字符串时，int() 的语法解析器非常严格。它要求字符串内容必须符合指定的整型字面量格式，否则将抛出 ValueError。

1. 纯十进制字符串转换

默认情况下（base=10），字符串允许包含以下内容：

• 前导和尾随的空白字符（会被自动忽略）；
• 可选的正负符号（+ 或 -）；
• 连续的 ASCII 数字字符（0-9）；
• 数字之间的单下划线分隔符（Python 3.6+ 支持，如 "1_000_000"）。

# 示例：合法十进制字符串转换
print(int("  128  "))     # 示例输出：128
print(int("-42"))         # 示例输出：-42
print(int("1_000_000"))   # 示例输出：1000000

2. 指定进制（base 参数）转换

base 参数支持从 2 到 36 之间的任意基数。转换时字符串中的数字或字母必须在相应进制的有效字符集内：

# 示例：二进制解析（base=2）
print(int("1010", 2))       # 示例输出：10

# 示例：十六进制解析（base=16）
print(int("1a", 16))        # 示例输出：26
print(int("0x1f", 16))      # 示例输出：31（可带前缀）

# 示例：base=0 自动识别前缀
print(int("0b1011", 0))     # 示例输出：11（自动按二进制解析）
print(int("0o77", 0))       # 示例输出：63（自动按八进制解析）
print(int("0xff", 0))       # 示例输出：255（自动按十六进制解析）

图3：字符串转整数操作步骤与异常防御逻辑

四、常见报错排查：为什么 int("3.14") 会报错？

初学者最常遇到的异常莫过于：

int("3.14")
# 抛出异常：ValueError: invalid literal for int() with base 10: '3.14'

1. 报错根源剖析

在 Python 的词法规则中，"3.14" 属于浮点数字面量，其中包含的小数点 . 并不是十进制整数的合法字符。int() 解析字符串时遵循的是严格匹配整型字面量的规则，它不会自动尝试将字符串先理解为浮点数再做截断。

2. 正确解决方案

如果业务数据可能传入带小数点的数值字符串，必须采取“中转”或针对性转换方案：

# 解决方案 A：先解析为浮点数，再截断为整数
val_str = "3.14"
val_int = int(float(val_str))
print(val_int)  # 示例输出：3

# 解决方案 B：通过字符串分割直接截取整数位（仅限确定为非科学计数法的正数场景）
val_int_split = int(val_str.split(".")[0])
print(val_int_split)  # 示例输出：3

3. 防御性转换函数示例

在面对不可控的用户输入或网络请求数据时，编写带异常捕获的工具函数能有效提高程序的健壮性：

def safe_to_int(value, default=0):
    """
    安全地将输入转换为整数。
    若转换失败，返回指定的默认值。
    """
    if value is None:
        return default
    try:
        # 先尝试直接转换（支持 int、合法整数字符串）
        return int(value)
    except (ValueError, TypeError):
        try:
            # 尝试先转浮点数（支持浮点字符串如 "3.14"、科学计数法 "1e3"）
            return int(float(value))
        except (ValueError, TypeError):
            return default

# 示例调用
print(safe_to_int("42"))       # 示例输出：42
print(safe_to_int("3.99"))     # 示例输出：3
print(safe_to_int("invalid"))  # 示例输出：0
print(safe_to_int(None, -1))   # 示例输出：-1

五、总结与转换规则速查

在日常开发中，熟练掌握 int() 的类型敏感特性能够避免大多数类型转换异常。以下是不同输入类型与对应处理结果的速查矩阵：

图4：int() 函数常见输入类型及转换行为总结矩阵