如何将 Python 2 代码迁移到 Python 3

简介

Python 是在 1980 年代末开发的，并于 1991 年首次发布。Python 的名字灵感来自于英国喜剧团体蒙提·派森，Python 被构想为命令式通用编程语言 ABC 的继任者。在最初的版本中，Python 已经包括了异常处理、函数和具有继承性的类。

本教程将指导您在将代码从 Python 2 迁移到 Python 3 时应考虑的最佳实践和注意事项，以及您是否应该维护与两个版本兼容的代码。

背景

Python 2 于 2000 年发布，标志着一种更加透明和包容的语言开发过程。它包括了更多的编程特性，并在其发展过程中添加了更多功能。

Python 3 被视为 Python 的未来，是目前正在开发中的语言版本。Python 3 于 2008 年末发布，解决并修正了内在的设计缺陷。然而，由于 Python 3 与 Python 2 不兼容，Python 3 的采用速度较慢。

Python 2.7 于 2010 年发布，是 2.x 系列的最后一个版本。Python 2.7 的目的是通过在两者之间提供一定程度的兼容性，使 Python 2.x 用户更容易将功能迁移到 Python 3。

您可以通过阅读我们的教程“Python 2 vs Python 3: 实际考虑”来了解更多关于 Python 版本和选择使用哪个版本的信息。

从 Python 2.7 开始

要迁移到 Python 3，或者同时支持 Python 2 和 Python 3，您应确保您的 Python 2 代码完全兼容 Python 2.7。

许多开发人员已经在专门使用 Python 2.7 代码，但重要的是要确认任何仅受早期版本支持的内容在 Python 2.7 中能够正常工作，并且符合 Python 2.7 的风格。

确保您的代码在 Python 2.7 中运行良好尤为重要，因为它是仍在维护和接收错误修复的唯一 Python 2 版本。如果您使用的是 Python 2 的早期版本，您将不得不解决不再受支持且不再接收错误修复的代码中遇到的问题。

此外，一些使您更容易迁移代码的工具，如寻找编程错误的 Pylint 包，不支持早于 2.7 版本的 Python。

需要牢记的是，尽管 Python 2.7 目前仍在得到支持和维护，但它最终将会终止生命周期。PEP 373 详细说明了 Python 2.7 的发布计划，并在撰写本文时将其终止日期标记为 2020 年。

测试覆盖率

创建测试用例可能是迁移 Python 2 到 Python 3 代码的重要部分。如果您维护多个 Python 版本，还应确保您的测试套件总体上具有良好的覆盖率，以确保每个版本仍然按预期工作。

作为测试的一部分，您可以将交互式 Python 用例添加到所有函数、方法、类和模块的文档字符串中，然后使用内置的 doctest 模块验证它们是否按预期工作。

除了 doctest，您还可以使用 coverage.py 包来跟踪单元测试覆盖率。该工具将监视您的程序，并记录已执行的代码部分以及可能已执行但未执行的部分。coverage.py 可以在命令行打印报告，也可以提供 HTML 输出。通常用于衡量测试的有效性，显示哪些代码部分通过测试得到执行，哪些没有。

需要记住的是，您并不是在追求 100% 的测试覆盖率 — 您要确保覆盖任何令人困惑或不寻常的代码。根据最佳实践，您应该追求 80% 的覆盖率。

了解 Python 2 和 Python 3 之间