如何在 Python 2 和 3 兼容代码中安全地使用长整型类型-Python教程-PHP中文网

如何在 Python 2 和 3 兼容代码中安全地使用长整型类型

在需同时支持 Python 2 和 3 的遗留项目中，为避免 long 类型在 Python 3 中不存在导致的兼容性错误，应统一使用别名（如 long_t）指向 int 或内置 long，而非直接重定义 long 变量。

在需同时支持 python 2 和 3 的遗留项目中，为避免 `long` 类型在 python 3 中不存在导致的兼容性错误，应统一使用别名（如 `long_t`）指向 `int` 或内置 `long`，而非直接重定义 `long` 变量。

Python 2 和 3 在整数类型设计上存在根本差异：Python 2 区分 int（固定宽度，通常 32/64 位）和 long（任意精度），而 Python 3 统一为单一 int 类型，其行为等价于 Python 2 的 long。因此，在跨版本代码中直接写 long(x) 会因 Python 3 中无 long 内置名而报 NameError；但若尝试在函数内通过条件赋值“修复”它（如 if py3: long = int），又会触发 UnboundLocalError: local variable 'long' referenced before assignment ——根本原因在于 Python 的作用域解析规则（LEGB）。

当 Python 解析器在函数体中看到对 long 的赋值语句（哪怕在 if 分支中），就会将 long 标记为该函数的局部变量。此后，任何对该名称的读取（如 long(bar)）都会被当作访问未初始化的局部变量，即使该赋值语句实际未执行（如在 Python 2 下 sys.version_info[0] >= 3 为 False）。此时，解释器不会回退查找全局/内置作用域中的 long，从而导致崩溃。

✅ 正确做法是：避免遮蔽内置名，改用明确的、非内置的别名（如 long_t, int_t, IntType）：

Secure Python Code Sandbox

安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

import sys

# 在模块顶层或函数开头统一定义（推荐模块级，避免重复判断）
if sys.version_info[0] >= 3:
    long_t = int
else:
    long_t = long  # Python 2 内置类型

# 使用时：
blockstotal = long_t(stats[3][2])
blocksfree = long_t(stats[3][4])

⚠️ 注意事项：

切勿在函数内直接赋值 long = int：这会污染局部作用域，引发 UnboundLocalError。
优先在模块顶层定义兼容别名：一次判断，全局复用，清晰且高效。
现代替代方案：若项目已可弃用 Python 2，应直接使用 int 并移除兼容逻辑；若仍需兼容，也可借助 six 或 future 库（如 from builtins import int as long_t），但纯标准库方案更轻量。
类型提示注意：long_t 是运行时别名，静态类型检查器（如 mypy）可能无法自动识别其等价性，必要时可用 typing.TYPE_CHECKING 或 Union[int, long]（Python 2）做适配。