Python 2.7 迁移到 3.9 语法兼容性问题有哪些

Python 2.7 到 3.9 的迁移核心在于语法断裂和标准库行为变更，直接运行通常会报错，需要结合自动化工具和人工修正。

先说结论：这是一项需要分阶段执行的工程任务，不能指望一次性切换成功。

先确认：用工具扫描代码和依赖的兼容性，找出阻碍升级的具体模块。
先处理：优先解决语法差异（如 print、除法）和废弃 API 调用。
再验证：在隔离环境中运行测试用例，确保业务功能正常。

核心语法差异与代码对比

以下是迁移中最常遇到的语法断裂点，需逐一排查修正：

1. Print 语句变函数

# Python 2.7
print "Hello World"

# Python 3.9 (语法错误)
print "Hello World"

# 修正后
print("Hello World")

2. 整数除法行为变更

# Python 2.7
print 1/2  # 输出 0

# Python 3.9
print 1/2  # 输出 0.5

# 修正建议：涉及整除显式使用 //
print 1//2 # 输出 0

3. 异常捕获语法

# Python 2.7
try:
    pass
except Exception, e:
    print e

# Python 3.9 (语法错误)
except Exception, e:

# 修正后
except Exception as e:
    print(e)

4. 字典迭代方法移除

# Python 2.7
for k, v in dict.iteritems():
    pass

# Python 3.9 (AttributeError)
dict.iteritems()

# 修正后
for k, v in dict.items():
    pass

迁移工具与命令实操

以下命令可帮助快速识别兼容性障碍，建议在虚拟环境中执行：

# 检查依赖包是否支持 Python 3
pip install caniusepython3
caniusepython3 -r requirements.txt

# 自动扫描代码语法差异（只查看不修改）
2to3 -p your_project_folder

# 使用 futurize 进行现代化改造（保留 Python 2 兼容性）
futurize `--stage1` -w your_project_folder

注意：2to3 工具生成的代码可能不符合现代 Python 3 规范，仅适合作为参考，生产环境代码建议人工复核。

验证方法与常见报错

代码修改完成后，不能仅凭启动成功判断迁移完成，需通过以下维度验证：

语法编译检查：使用 python3 -m py_compile script.py 批量检查文件语法。
单元测试通过率：运行原有的测试套件，确保覆盖率达标，核心逻辑无回归。
日志无报错：启动应用后观察日志，确保没有 ImportError 或 AttributeError。

常见坑

Unicode 字符串：Python 2 中 unicode 类型在 Python 3 中合并为 str，涉及编码解码的地方容易乱码，建议统一使用 utf-8。
第三方库版本：部分老旧库可能不再维护，若无法找到支持 Python 3 的版本，需考虑重构该部分功能。
环境共存：不要直接卸载 Python 2.7，建议通过别名区分 python2 和 python3，确保旧项目不受影响。

参考来源

Python 官方文档：Porting Python 2 Code to Python 3
Python 3.9 官方发布说明 (What's New In Python 3.9)
caniusepython3 项目官方仓库