Python 版本问题：Python 2 与 Python 3 语法兼容

Python 2 和 Python 3 是两个不兼容的主版本。如果你维护的代码需要同时在两个版本中运行，必须处理关键语法差异。以下步骤教你如何编写兼容代码，并安全迁移。

识别常见不兼容点

检查你的代码是否包含以下典型差异：

print 语句 vs 函数
Python 2 允许 print "hello"，但 Python 3 要求 print("hello")。
整数除法行为
Python 2 中 5 / 2 返回 2（整数除法），Python 3 返回 2.5（真除法）。
Unicode 字符串处理
Python 2 默认字符串是字节（str），而 Python 3 默认是 Unicode（str）。
xrange 与 range
Python 2 的 xrange() 在 Python 3 中被移除，range() 行为等同于旧版 xrange。
异常语法
Python 2 支持 except ValueError, e:，Python 3 只接受 except ValueError as e:。

使用以下策略让同一份代码在 Python 2.7 和 Python 3.x 中都能运行。

导入兼容层
在文件顶部添加：
```
from __future__ import print_function
from __future__ import division
from __future__ import unicode_literals
```
这三行分别启用 Python 3 的 print() 函数、真除法 / 行为，以及默认 Unicode 字符串。
统一字符串处理
明确区分字节和文本：
- 文本字符串：用 u"文本"（Python 2 需要 unicode_literals）
- 字节字符串：用 b"bytes"

替换 xrange 为 range
在模块开头加入：

try:
    range = xrange  # Python 2
except NameError:
    pass  # Python 3

使用 six 库处理复杂差异
安装 six（一个轻量级兼容库）：

pip install six

然后在代码中：

import six

if six.PY2:
    # Python 2 专用逻辑
elif six.PY3:
    # Python 3 专用逻辑

运行工具自动发现或修复兼容性问题。

使用 python-modernize 扫描代码
安装并执行：
```
pip install modernize
python-modernize your_script.py
```
它会输出建议修改的代码行，并可加 -w 参数直接重写文件。
用 2to3 转换（仅用于迁移到 Python 3）
如果决定放弃 Python 2 支持：
```
2to3 -w your_project/
```
此命令将递归转换整个目录到 Python 3 语法。
在 CI 中加入双版本测试
配置 .github/workflows/test.yml 或类似持续集成脚本，确保代码在 Python 2.7 和 3.6+ 下都通过测试。

以下表格列出最常遇到的语法/行为差异及兼容写法：

功能	Python 2 写法	Python 3 写法	兼容方案
输出	`print "a"`	`print("a")`	`from __future__ import print_function`
除法	`5 / 2 → 2`	`5 / 2 → 2.5`	`from __future__ import division`
整数范围	`xrange(10)`	`range(10)`	`try: range = xrange\nexcept: pass`
字符串类型	`str` 是字节	`str` 是 Unicode	显式用 `u""` 和 `b""`
字典方法	`.iterkeys()`	`.keys()` 返回视图	用 `list(dict.keys())` 获取列表
输入函数	`raw_input()`	`input()`	`from six.moves import input`

优先考虑完全迁移到 Python 3。Python 2 已于 2020 年停止官方支持，继续使用存在安全风险。若因遗留系统必须支持双版本，遵循上述步骤最小化差异，并通过自动化测试保障稳定性。