刪除對Python 2.6及更早版本的支持?

雖然你可以讓 Python 2.5 與 Python 3 一起工作，但如果你只需要與 Python 2.7 一起工作，那就會(huì ) 更加容易。 如果放棄 Python 2.5 不是一種選擇，那么 six 項目可以幫助你同時(shí)支持 Python 2.5 和 3 (python -m pip install six)。 不過(guò)請注意，本 HOWTO 中列出的幾乎所有項目都有可能會(huì )不再可用。

如果你能夠跳過(guò)Python 2.5和更早的版本，那么對你的代碼所做的必要修改應該看起來(lái)和感覺(jué)上都是你已經(jīng)習慣的Python代碼。在最壞的情況下，你將不得不使用一個(gè)函數而不是一個(gè)實(shí)例方法，或者不得不導入一個(gè)函數而不是使用一個(gè)內置的函數，但除此之外，整體的轉變應該不會(huì )讓你感到陌生。

但你的目標應該是只支持 Python 2.7。Python 2.6 不再被免費支持，因此也就沒(méi)有得到錯誤修復。這意味著(zhù)**你**必須解決你在Python 2.6上遇到的任何問(wèn)題。本HOWTO中提到的一些工具也不支持Python 2.6 (例如，Pylint)，隨著(zhù)時(shí)間的推移，這將變得越來(lái)越普遍。如果你只支持你必須支持的Python版本，那么對你來(lái)說(shuō)會(huì )更容易。

確保你在你的``setup.py``文件中指定適當的版本支持?

在你的``setup.py``文件中，你應該有適當的 trove classifier 指定你支持哪些版本的 Python。由于你的項目還不支持 Python 3，你至少應該指定``Programming Language :: Python :: 2 :: Only``。理想情況下，你還應該指定你所支持的Python的每個(gè)主要/次要版本，例如：Programming Language :: Python :: 2.7。.

良好的測試覆蓋率?

一旦你的代碼支持了你希望的Python 2的最老版本，你將希望確保你的測試套件有良好的覆蓋率。一個(gè)好的經(jīng)驗法則是，如果你想對你的測試套件有足夠的信心，在讓工具重寫(xiě)你的代碼后出現的任何故障都是工具中的實(shí)際錯誤，而不是你的代碼中的錯誤。如果你想要一個(gè)目標數字，試著(zhù)獲得超過(guò)80%的覆蓋率（如果你發(fā)現很難獲得好于90%的覆蓋率，也不要感到遺憾）。如果你還沒(méi)有一個(gè)測量測試覆蓋率的工具，那么推薦使用coverage.py。

了解Python 2 和 3之間的區別?

一旦你的代碼經(jīng)過(guò)了很好的測試，你就可以開(kāi)始把你的代碼移植到 Python 3 上了！ 但是為了充分了解你的代碼將發(fā)生怎樣的變化，以及你在編碼時(shí)要注意什么，你將會(huì )想要了解 Python 3 相比 Python 2 的變化。 通常來(lái)說(shuō)，兩個(gè)最好的方法是閱讀 Python 3 每個(gè)版本的 "What's New" 文檔和 Porting to Python 3 書(shū)（在線(xiàn)免費版本）。還有一個(gè)來(lái)自 Python-Future 項目的便利 cheat sheet。

更新代碼?

一旦你覺(jué)得你知道了 Python 3 與 Python 2 相比有什么不同，就是時(shí)候更新你的代碼了！ 你可以選擇兩種工具來(lái)自動(dòng)移植你的代碼: Futurize 和 Modernize。 你選擇哪個(gè)工具將取決于你希望你的代碼有多像 Python 3。 Futurize 盡力使 Python 3 的習性和做法在 Python 2 中存在，例如，從 Python 3 中回傳 bytes 類(lèi)型，這樣你就可以在 Python 的主要版本之間實(shí)現語(yǔ)義上的平等。 另一方面，Modernize 更加保守，它針對的是 Python 2/3 的子集，直接依靠 six 來(lái)幫助提供兼容性。 由于 Python 3 是未來(lái)，最好考慮 Futurize，以開(kāi)始適應 Python 3 所引入的、你還不習慣的任何新做法。

無(wú)論你選擇哪種工具，它們都會(huì )更新你的代碼，使之在Python 3下運行，同時(shí)與你開(kāi)始使用的Python 2版本保持兼容。根據你想要的保守程度，你可能想先在你的測試套件上運行該工具，并目測差異以確保轉換的準確性。在你轉換了你的測試套件并驗證了所有的測試仍然如期通過(guò)后，你就可以轉換你的應用程序代碼了，因為你知道任何測試失敗都是轉譯的錯誤。

不幸的是，這些工具不能自動(dòng)地使你的代碼在Python 3下工作，因此有一些東西你需要手動(dòng)更新以獲得對Python 3的完全支持（這些步驟在不同的工具中是必要的）。閱讀你選擇使用的工具的文檔，看看它默認修復了什么，以及它可以選擇做什么，以了解哪些將（不）為你修復，哪些你可能必須自己修復（例如，在Modernize中使用``io.open()``覆寫(xiě)內置的``open()``函數默認是關(guān)閉的）。不過(guò)幸運的是，只有幾件需要注意的事情，可以說(shuō)是大問(wèn)題，如果不注意的話(huà)，可能很難調試。

import sys

if sys.version_info[0] == 3:
    from importlib import abc
else:
    from importlib2 import abc

import sys

if sys.version_info[0] > 2:
    from importlib import abc
else:
    from importlib2 import abc

try:
    from importlib import abc
except ImportError:
    from importlib2 import abc

防止兼容性退步?

一旦你完全翻譯了你的代碼，使之與 Python 3 兼容，你將希望確保你的代碼不會(huì )退步，不會(huì )在 Python 3上停止工作。如果你有一個(gè)依賴(lài)關(guān)系阻礙了你目前在Python 3上的實(shí)際運行，那就更是如此了。

為了幫助保持兼容，你創(chuàng )建的任何新模塊都應該在其頂部至少有以下代碼塊:

from __future__ import absolute_import
from __future__ import division
from __future__ import print_function

你也可以在運行Python 2時(shí)使用``-3``標志，對你的代碼在執行過(guò)程中引發(fā)的各種兼容性問(wèn)題進(jìn)行警告。如果你用``-Werror``把警告變成錯誤，那么你可以確保你不會(huì )意外地錯過(guò)一個(gè)警告。

你也可以使用 Pylint 項目和它的``--py3k``標志來(lái)提示你的代碼，當你的代碼開(kāi)始偏離 Python 3 的兼容性時(shí)，就會(huì )收到警告。這也避免了你不得不定期在你的代碼上運行 Modernize 或 Futurize 來(lái)捕捉兼容性的退步。這確實(shí)要求你只支持Python 2.7和Python 3.4或更新的版本，因為這是Pylint支持的最小Python版本。

檢查哪些依賴(lài)性會(huì )阻礙你的過(guò)渡?

在你使你的代碼與 Python 3 兼容**之后**，你應該開(kāi)始關(guān)心你的依賴(lài)關(guān)系是否也被移植了。 caniusepython3 項目的建立是為了幫助你確定哪些項目——直接或間接地——阻礙了你對Python 3的支持。它既有一個(gè)命令行工具，也有一個(gè)在 https://caniusepython3.com 的網(wǎng)頁(yè)界面。

該項目還提供了一些代碼，你可以將其集成到你的測試套件中，這樣，當你不再有依賴(lài)關(guān)系阻礙你使用Python 3時(shí)，你將有一個(gè)失敗的測試。這使你不必手動(dòng)檢查你的依賴(lài)性，并在你可以開(kāi)始在Python 3上運行時(shí)迅速得到通知。

更新你的``setup.py``文件以表示對Python 3的兼容?

一旦你的代碼在 Python 3 下工作，你應該更新你``setup.py``中的分類(lèi)器，使其包含``Programming Language :: Python :: 3``并不指定單獨的 Python 2 支持。這將告訴使用你的代碼的人，你支持Python 2 和 3。理想情況下，你也希望為你現在支持的Python的每個(gè)主要/次要版本添加分類(lèi)器。

使用持續集成以保持兼容?

一旦你能夠完全在Python 3下運行，你將希望確保你的代碼總是在Python 2和3下工作。在多個(gè)Python解釋器下運行測試的最好工具可能是 tox 。然后你可以將 tox 與你的持續集成系統集成，這樣你就不會(huì )意外地破壞對 Python 2 或 3 的支持。

你可能還想在 Python 3 解釋器中使用``-bb``標志，以便在你將bytes與string或bytes與int進(jìn)行比較時(shí)觸發(fā)一個(gè)異常（后者從 Python 3.5 開(kāi)始可用）。默認情況下，類(lèi)型不同的比較只是簡(jiǎn)單地返回``False``，但是如果你在文本/二進(jìn)制數據處理或字節的索引分離中犯了一個(gè)錯誤，你就不容易發(fā)現這個(gè)錯誤。當這些類(lèi)型的比較發(fā)生時(shí)，這個(gè)標志會(huì )觸發(fā)一個(gè)異常，使錯誤更容易被發(fā)現。

基本上就是這樣了! 在這一點(diǎn)上，你的代碼庫同時(shí)與 Python 2 和 3 兼容。你的測試也將被設置為不會(huì )意外地破壞 Python 2 或 3 的兼容性，無(wú)論你在開(kāi)發(fā)時(shí)通常在哪個(gè)版本下運行測試。

考慮使用可選的靜態(tài)類(lèi)型檢查?

另一個(gè)幫助移植你的代碼的方法是在你的代碼上使用靜態(tài)類(lèi)型檢查器，如 mypy 或 pytype。這些工具可以用來(lái)分析你的代碼，就像它在Python 2下運行一樣，然后你可以第二次運行這個(gè)工具，就像你的代碼在Python 3下運行一樣。通過(guò)像這樣兩次運行靜態(tài)類(lèi)型檢查器，你可以發(fā)現你是否錯誤地使用了二進(jìn)制數據類(lèi)型，例如在Python的一個(gè)版本中與另一個(gè)版本相比。如果你在你的代碼中添加了可選的類(lèi)型提示，你也可以明確說(shuō)明你的API是使用文本數據還是二進(jìn)制數據，這有助于確保在兩個(gè)版本的Python中所有的功能都符合預期。