Python类型转换内置函数int、str、float的使用规范

在 Python 开发中，int()、float() 和 str() 是处理外部输入、API 数据解析与数值计算时调用频次最高的三个内置类型转换函数。显式转换的核心逻辑在于“确保数据以合法的底层内存结构参与后续运算”。若不清楚各函数的合法输入边界、截断与舍入特性以及进制解析规则，极易在生产环境引发突发性 ValueError 或隐匿的浮点精度缺陷。本文将系统拆解这三个函数的基础规则、边界约束与防御性编程实践。

图 1：int、str 与 float 相互转换的拓扑路径与核心约束

一、int() 函数的规范用法与边界

int() 构造器主要用于将数值对象或特定进制的字符串转换为整型。在日常调用中，参数类型决定了内部的解析路线。

1. 浮点数转整型：向零截断而非四舍五入

当参数为 float 时，int() 会直接丢弃小数部分，执行向零截断（Truncation toward zero）。这意味着对于正数是向下取整，对于负数则是向上取整，它绝不等同于四舍五入或向下取整函数 math.floor()。

# 示例代码：浮点截断表现
val_pos = int(5.99)
val_neg = int(-5.99)

print(f"int(5.99)  = {val_pos}")
print(f"int(-5.99) = {val_neg}")

2. 字符串转整型：字面量纯净度与进制解析

当参数是字符串时，要求字符串内容必须是纯粹的整数表达形式。默认情况下（base=10），字符串两端允许存在空白字符，但严禁包含小数点、科学计数法字符或除正负号外的任何符号。

# 正确用法
int("  42  ")   # 42，自动滤除两端空白
int("-100")     # -100，支持正负前缀

# 典型错误：包含小数点的字符串无法被 int() 直接解析
try:
    int("42.0")
except ValueError as e:
    print(f"捕获异常: {e}")

如果需要转换非十进制表示的字符串，必须显式声明 base 参数。此时第一个参数必须为字符串类型，若传入整型或浮点型将抛出 TypeError。

# 二进制、十六进制转换
bin_val = int("1010", base=2)      # 10
hex_val = int("0x1f", base=16)     # 31
auto_val = int("0o77", base=0)     # 63，base=0 会依据前缀 0b/0o/0x 自行推导

二、float() 函数的使用规范与精度事实

float() 函数将数字或字符串转为底层以 C 语言 double 实现的 64 位 IEEE 754 双精度浮点数。

1. 字符串支持的浮点语法

与 int() 相比，float() 对字符串的包容度更高。它支持整数形式、标准小数形式、科学计数法，以及特殊字面量：

• 标准浮点形式：float("3.14159")
• 无前导或后置零形式：float(".5")（解析为 0.5）、float("5.")（解析为 5.0）
• 科学计数法：float("1e-4")（解析为 0.0001）、float("-2.5E3")（解析为 -2500.0）
• 特殊常量：float("inf")、float("-inf")、float("nan")（不区分大小写）

2. 浮点精度与溢出边界

Python 整型是无限精度的，只要内存足够就可以无限增长；但 float 受限于 IEEE 754 双精度标准，其有效数字约为 15 到 17 位十进制数，最大值约为 1.79e+308。一旦数值超出表示上限，会直接抛出 OverflowError。

# 精度丢失场景
large_num = 9007199254740993  # 超出 2^53 的大整数
f_num = float(large_num)
print(f"原始整数: {large_num}")
print(f"转为浮点: {int(f_num)}")

因此，对于金融结算、货币计算或超过 15 位的订单号，切勿通过 float() 转换进行数值比对或计算，应使用标准库中的 decimal.Decimal 模块。

三、str() 函数与文本转换规范

str() 用于将任何 Python 对象转化为适合人类阅读的字符串表达。在绝大多数情况下，str() 调用永远不会失败，但它的输出格式直接取决于对象内部实现的 __str__() 方法。

图 2：str() 转换的调用层级与回退逻辑

1. 数值转字符串时的浮点表现

在将浮点数传给 str() 时，Python 默认采用最短可逆表示算法（Grisu3 / Dragon4 系列演进）。极小或极大的数值会自动转化为科学计数法字符串：

val_small = 0.0000000000001
val_standard = 3.14

print(str(val_standard))  # "3.14"
print(str(val_small))     # "1e-13" (自动转为科学计数法)

如果业务系统（如对接老旧银行接口或生成固定格式报表）不能接受科学计数法，应当使用格式化字符串显式声明格式化规则，而不是直接使用 str()：

# 规避科学计数法的输出规范
formatted_str = f"{val_small:.15f}"
print(formatted_str)      # "0.000000000000100"

四、三者互转的典型场景与安全落地步骤

在处理外部接口、用户表单或 CSV 导入时，外部输入的数据几乎统一表现为 str。最容易引发线上故障的场景是将包含小数文本的字符串（如 "128.5" 或 "128.0"）直接转为整型。

图 3：字符串解析至数值的标准四步落地路径

操作场景：将字符串 "99.8" 转为整型

若需求是直接截取整数位，标准规范是先使用 float() 解析文本，再使用 int() 截断小数；若业务需要就近取整，则应配合 round()：

raw_input = "99.8"

# 错误示例：直接报错崩溃
# result = int(raw_input) # 抛出 ValueError

# 正确规范 1：向零截断取整 -> 99
truncated_val = int(float(raw_input))

# 正确规范 2：四舍六入五成双（Python标准round）-> 100
rounded_val = int(round(float(raw_input)))

print(f"原始字串: '{raw_input}'")
print(f"截断取整: {truncated_val}")
print(f"四舍五入: {rounded_val}")

五、生产环境的防御性转换规范

在生产级代码中，直接裸写 int(x) 或 float(x) 属于高风险操作。脏数据、空值（None 或空字符串）会导致服务因未捕获的 TypeError 或 ValueError 中断。推荐遵循以下三项编写规范：

1. 双重异常防御： 同时捕获 (ValueError, TypeError)。前者防范非法格式内容（如 "abc"），后者防范不兼容的参数类型（如传入了 None 或列表）。
2. 安全转换包装器： 编写带有默认返回值（fallback）的纯函数完成解构。
3. 布尔型（bool）陷阱防范： 在 Python 中，bool 是 int 的子类。int(True) 返回 1，int(False) 返回 0。如果业务禁止布尔值隐式转为数值，必须显式拦截。

from typing import Any, Optional

def safe_to_int(val: Any, default: Optional[int] = 0, strict: bool = True) -> Optional[int]:
    """
    安全地将任意类型值转换为 int。
    :param val: 待转换输入
    :param default: 转换失败时的兜底返回值
    :param strict: 是否严格禁止 bool 参与数值转换
    :return: 转换后的整型结果或默认值
    """
    if strict and isinstance(val, bool):
        return default
        
    try:
        if isinstance(val, str):
            val = val.strip()
            # 兼容包含小数点的文本形式
            return int(float(val))
        return int(val)
    except (ValueError, TypeError, OverflowError):
        return default

# 验证边界测试用例
print("safe_to_int(' 128.9 '):", safe_to_int(" 128.9 "))
print("safe_to_int(None):", safe_to_int(None))
print("safe_to_int('invalid'):", safe_to_int("invalid", default=-1))
print("safe_to_int(True, strict=True):", safe_to_int(True, strict=True))
print("safe_to_int(True, strict=False):", safe_to_int(True, strict=False))

六、总结与特性对照

掌握类型转换规范的根本在于明确各类转换的触发条件与限制边界。下表系统归纳了三个函数的核心行为与安全要点：

图 4：类型转换三大核心规范总结

在日常开发中，把类型转换视为“数据格式协议的校验与落地”过程，明确截断行为，做好空值与字符合法性防御，是编写健壮、可维护 Python 系统的基础保障。