如何判断Python模块适配Python 2/3？相关标注约定解析

你说得没错，Python 2和3的差异确实让单纯的自动分析很难精准判断模块的兼容性，不过社区里有不少约定和实践可以帮你快速识别模块的目标版本，下面我整理了几个常用的方法：

1. __future__ 导入语句 #

这是最常见的版本信号之一，如果模块顶部有这类导入，往往是在做版本兼容或者明确目标版本：

• 比如 from __future__ import print_function、from __future__ import division 这类，通常意味着代码是为了兼容Python 3而写，或是从Python 2过渡到3的代码。
• 如果没有任何__future__导入，且代码里用了print语句（不是函数调用print()）、旧式除法（5/2得到整数2），那大概率是Python 2专属的。

2. 版本检测代码 #

很多兼容模块里会直接写版本判断逻辑，一眼就能看出适配范围：

import sys
if sys.version_info[0] == 2:
    # Python 2 专属处理
    text = unicode(text)
elif sys.version_info[0] == 3:
    # Python 3 专属处理
    text = str(text)

如果代码里只有针对Python 2的分支、完全没处理3的逻辑，那基本就是只适配2；反之同理。

3. 包配置文件标注 #

如果是可安装的第三方包，配置文件里会明确标注支持的Python版本：

• setup.py：通过python_requires参数声明，比如：

  setup(
      ...
      python_requires=">=2.7, !=3.0.*, !=3.1.*",
      ...
  )
  

• pyproject.toml：现代包会用这个文件，里面的requires-python字段也会清晰说明版本范围。
• tox.ini：测试配置文件里的envlist会列出要测试的Python版本，比如envlist = py27,py38，说明包支持这两个版本。

4. 社区约定的文件命名技巧 #

你提到没找到.py2/.py3这类扩展名，确实没有官方统一的扩展名，但有些项目会用这类命名方式拆分版本专属代码：

• 比如把Python 2专属代码放在mymodule_py2.py，Python 3的放在mymodule_py3.py，然后主模块根据当前Python版本导入对应的文件。
• 另外，很多项目会在README或项目文档的开头直接说明支持的版本，比如“仅支持Python 2.7”或“Python 3.6+兼容”，这其实是最直观的标注方式。

5. 语法与API特性差异 #

一些语法和API是版本专属的，一眼就能区分：

• Python 2独有的xrange()、iteritems()、unicode()类型，在Python 3里被替换成range()、items()、str()，如果代码大量使用前者且无兼容处理，就是Python 2的。
• Python 3新增的f-string（f"{var}"）、类型注解、async/await语法，这些代码肯定是针对Python 3的，因为Python 2完全不支持。

总结 #

没有像.py2/.py3那样单一的官方标记，但结合__future__导入、版本检测代码、配置文件声明、语法特性这些点，就能基本判断模块的目标版本。很多时候，项目的文档和配置文件是最直接的信息来源。

内容的提问来源于stack exchange，提问作者algal